INTRODUCTION 


This manual gives complete descriptions of all the publicly 
available features of UNIX, It provides neither a general ove. 
view (see The UNIX Time-sharing System for that) nor details ¢« 
the implementation of the system (which remain to be disclosed). 


Within the area it surveys, this manual attempts to be as com- . 
plete and timely as possible. A conscious decision was made to 
describe each program in exactly the state it was in at the time 
its manual section was prepared, In particular, the desire to 
describe something as it should be, not as it is, was resisted. 
Inevitably, this means that many sections will soon be out of. 
date, (The rate of change of the system is so great that a 

' dismayingly large number of early sections had to be modified 
while the rest were being written. The unbounded effort required 
to stay up-to-date is best indicated by the fact that several of 
the programs described were written specifically to aid in 
preparation of this manual!) 


This manual is divided into seven sections: 


I. Commands 

II. System calls 

III. Subroutines 

IV. Special files 

V. File formats 

VI. User-maintained programs 
VII, Miscellaneous 


Commands are programs intended to be invoked directly by the 
“user, in contradistinction to subroutines, which are intended to 
be called by the user’s programs, Commands generally reside ir, 
directory /bin (for binary programs). This directory is searched 
automatically by the command line interpreter, Some programs 
classified as commands are located elsewhere; this fact is indi- 
cated in the appropriate sections. : 


System calls are entries into the UNIX supervisor, In assembly 
language, they are coded with the use of the opcode sys ,a 
synonym for the trap instruction, 


The special files section discusses the characteristics sf each 
system “file which actually refers to an I/O device. 


The file formats section documents the structure of paticular 
kinds of files; for example, the form of the output of the loader 
and assembler is given. Excluded are files used by aly one com- 
mand, for example the assembler’s intermediate files 


User-maintained programs are not considered part ofthe UNIX sys- 


tem, and the principal reason for listing them is © indicate 
their existence without necessarily giving a complte 
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description. The author should be consulted for information. 


The miscellaneous section gathers odds and ends, 


Each section consists of a number of independent entries of a 
page or so each, The name of the entry is in the upper right 
corner of its pages, its preparation date in the upper left. 
Entries within each section are alphabetized, It was thought 
better to avoid page numbers, since it is hoped that the manual 
will be updated frequently. 


All entries have a common format, 


The name section repeats the entry name and gives a very 
short description of its purpose, 


The synopsis summarizes the use of the program being 
described, A few conventions are used, particularly in the 
Commands section: 


Underlined words are considered literals, and are typed 
just as they appear, 


Square brackets ([]) around an argument indicate that the 
argument is optional, When an argument is given as 
name , it always refers to a file name, 


Ellipses "ye. are used to show that the previous 
argument—prototype may be repeated. 


A final convertion is used by the commands, themselves. 

An argument beginning with a minus sign —- is often tak- 
en to mean some sort of flag argument even if it appears 

in a position where a file name could appear, Therefore, 
it is unwise to have files whose names begin with - 


The description section discusses in detail the subject at 
hand, 


The files section gives the names of files which are built 
into the program. 


A see also section gives pointers to related information, 


A diagnostics section discusses the diagnostics that may be 
produced, This section tends to be as terse as the diagnos-— 
tics themselves, 


The bugs section gives known bugs and sometimes deficien-— 
cies. Occasionally also the suggested fix is described. 


The owner section gives the name of the person or persons to 
be consulted in case of difficulty. The rule has been that 
the last one to modify something owns it, so the owner is 

not necessarily the author. The owner’s initials stand for: 
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ken K. Thompson 
dmr D. M. Ritchie 
jfo J. F. Ossanna 
rhm R. Morris 


These three-character names also happen to be UNIX user 
ID’s, so messages may be transmitted by the mail command or, 
if the addressee is logged in, by write. 


At the beginning of this document is a table of contents, organ- 

ized by section and alphabetically within each section. There is 
also a permuted index derived from the table of contents, Within 
each index entry, the title of the writeup to which it refers is 

followed by the appropriate section number in parentheses, This 

fact is important because there is considerable name duplication 

among the sections, arising principally from commands which exist 
only to exercise a particular system call. 


This manual was prepared using the UNIX text editor ed and the 
formatting program roff, 
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archive (combine) files 
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III, SUBROUTINES 
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sum file 

manipulate DECtape 

get time information 

find name of terminal 

print file on IBM 2741 
dismount removable file system 
find undefined symbols 

get (English) word count 

who is on the system 

write to another user 


set program break 

catch EMT traps 

change working directory 
change mode of file 

change owner of file 

close open file 

create file 

execute program file 
terminate execution 

create new process 

status of open file 

get user ID 

get typewriter mode 

catch illegal instruction trap 
catch or inhibit interrupts 
iink to file 
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get file status 

set system time 

set mode of typewriter 
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remove (delete) file 
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write file 
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IV. SPECIAL FILES 
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remote typewriter 
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directory format 

file system format 

password file 
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logged-in user information 


DEC supplied BASIC 

the game of black jack 
print calendar 

the game of chess 
disassembler 
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B assembler 

B compiler 


- vii - 


bilib bite 6.66 ete lere 0b Oe bees ea eces DB interpreter library 
DPLOC saceccccccsscreeeeveese LOCC procedure 
brt1,brt2 cece r eevee esvcceses B Start and finish 
£1,£2,£3,F4 w.cccsevcecceosess FOrtran compiler passes 
GlOD weccacecccccsencscesenee argument expander 

init eee eeeeern eer er erences es eee initializer process 
kbd eoeoeoeeoeoeeveeveeeveeeeee*eeneseeaevse @ map of TTY 37 keyboard 
LUDA w.encccccseevnccccvesceese Standard assembly-language library 
libb @eseeeteeeesevnseeoeeneeenseessene @ standard B library 


Llibft etandard PFPortran li 
ae A al dhe NA 


hraryv 
tv eseeoveeteertesseeeees @¢ @eeosvee#es Aa ssn et le ee dH Od ws. 


rary 
login, loqout ..ecsesesseeeees LOGGing on and logging off the system 
msh eeoeseetoeoeeoveeesveeeesveseeeseoeeeseese eo 6 mini Shell 

SULCAD: Silas eee eee Coke wee ew LOLE 8 SULTIS tape 


TADS cecnceccreccesesesesseee SEC tab stops on typewriter 


- viii - 


chmod(I):; change 
sdate(I): 

): send mail to 
te(I): write to 
ar(I): 
archive(V): 


glob(VITI); 


A@pt(V1I): read DEC 

bed(I): convert 

atof(III): convert 

atoi(III): convert 
ascii(VII): map of 
ctime(III): convert time to 
convert floating to 
itoa(III): convert integer to 


liba(VII): s 


ba(VIT) 

be(VITI) 
bilib(VII): 
libb(VII): standard 
b(I): compile 
brt1,brt2(VII); 
log(III): logarithm 


bas(I): 


basic(VI): DEC supplied 


bed(I): convert ASCII to 


su(I): 


bppt(V): 

Abppt(I): write 

lbppt(I): read 

dli(VI): load DEC 

remove symbols, relocation 


INDEX 


access mode of files 
adjust date and time 
another user 


annathar near : 
QangUcneLl user 


a,out(V): assembler and loader output 
archive (combine) files 
archive file 

archive(V): archive file 
argument expander 

ar(I): archive (combine) files 
ASCII paper tapes 

ASCII to BCD 

ASCII to floating 

ASCII to integer 

ASCII 

ASCII 

ASCII,..ftoa(III): 

ASCII 

ascii(VII): map of ASCII 
as(I): assembler 

assembler and loader output 
assembler 

assembler 

assembler’s pass 2 
assembly-language library 
as2(Vil): assembler’s pass 2 
atof(III): convert ASCII to floating 
atoi(III); convert ASCII to integer 
B assembler 

B compiler 

B interpreter library 

B library 

B program 

B start and finish 

base e 

bas(I); BASIC dialect 

BASIC dialect 

BASIC 

basic(VI): DEC supplied BASIC 
ba(VII): B assembler 

BCD 

bed(I): convert ASCII to BCD 
be(VII):; B compiler 

become super-user 

b(I): compile B program 
bilib(VII); B interpreter library 
binary paper tape format 
binary paper tape 

binary paper tape 

binary paper tapes 
bits...strip(I): 


bj(VI): the game of black jack 
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bj(VI): the game of 
bproc(VII): 


break(II): set program 
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ilgins(II): 
intr(II); 
quit(II): 


chown (IT 
chown(I): 
chdir(I); 
chdir(II): 
putc(III): write 
get(III): get 
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chess(VI); the game of 
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sh(I): 
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b(I): 
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poot(I): reboot system 
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bproc(VII): boot procedure 

break 

break(II): set program break 
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calculator 


calendar 
cal(VI): print calendar 
catch EMT traps 


catch illegai instruction trap 
catch or inhibit interrupts 

catch or inhibit quits 

cat(I): concatenate (or print) files 
cemt(II): catch EMT traps 

change access mode of files 

change mode of file 

change owner of file 
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change working directory 

change working directory 

character or word , 
character 

chdir(I): change working directory 
chdir(Ii): change working directory 
check consistency of file system 
aheck(T): 
chess 
chess(VI): the game of chess 
chmod(I): change access mode of files 
chmod(II): change mode of file 
chown(I): change owner of files 
chown(II): change owner of file 
close open file 

close(II): close open file 
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(combine) files 

command interpreter 

compare file contents 

compile B program 

compile Fortran program 

compiler passes 

compiler 

concatenate (or print) files 
consistency of file system 

console typewriter 

contents of directory 

contents 
convert 
convert 
convert 
convert 
convert 
convert 


ASCII to BCD 
ASCII to floating 
ASCII to integer 
floating to Ascii 
integer to ASCII 
time to ASCIT 
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sin(III): sine, 
we(I): get (English) word 


mkdir(I 
mkdir(II 
creat(II 
ak 
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fork(II) 


date(I): get 
sdate(I): adjust 
smdate(II): set 


@ate(I): get date and time of 


ab(I): symbolic 
apt (VI): read 
dli(vV1I): load 
basic(VI): 
tapO,...,tap7(IV): 
atf£(Ll}: format 
rew(I): rewind 
tap(I): manipulate 
rmdir(I}: remove 
rm(I): remove 
dsw(I): 
unlink(II): remove 
mesg(I): permit or 
switch(III): transfer 
ac(I): 

mount(I): mount 


bas(I): BASIC 
directory(V): 

chdir(I): change working 
chdir(II): change working 
ls(I): list contents of 
mkdir(I): create 
mkdir(II): create 
rmdir(I): remove (delete) 


das(VI): 

rfO(IV): RF 
rkO(IV): RK 
rkl(I): load 
af(I): find free 
rka(I): dump 
du(I): find 
rkf(I): format RK 


copy file 

core image file 

core memory as file 
core(V): core image file 
cosine 

count 

cp(I): copy file 

create directory 

create directory 

create file 

create new process 
creat(II): create file 
ctime(III); convert time to ASCII 
das(VI): disassembler 

date and time of day 

date and time 

date modified of file 
date(I): get date and time of day 
Gay 

@b(I): symbolic debugger 
abppt(I); write binary paper tape 
a@c(I): desk calculator 
debugger 

DEC ASCII paper tapes 

DEC binary paper tapes 

DEC supplied BASIC 

DECtape file 

DECtape 

DECtape 

DECtape 

(delete) directory 
(delete) file 

delete files interactively 
(delete) file 

deny messages 

depending on value 

desk calculator 

detachable file system 
df(I): find free disk space 
dialect 

directory format 

directory 

directory 

directory 

directory 

directory 

directory 

directory(V): directory format 
disassembler 

disk file 

disk file 

disk from tape 

disk space 

disk to tape 

disk usage 

disk 
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dismount file system 

dismount removable file system 
dli(VI): load DEC binary paper tapes 
dpt(VI): read DEC ASCII paper tapes 
dsw(I): delete files interactively 


umount(II): 
umount(I1):; 


rkda(I): 
od(I): octal 


exec(II): 
exit(II): terminate 


glob(VII): argument 


exp(III): 

emp(I): compare 

type(I): print 

stat(I): get 

stat(II): get 

file system(V): 
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mkfs(I): initialize 
mount(I): mount detachable 
mount (II); mount 
umount(I): dismount removable 
umount(II): dismount 


find(I): find 

pr(I): print 

archive(V): archive 
chmod(II): change mode of 
chown(II): change owner of 
close(II): close open 
core(V): core image 
ep(I): copy 

creat(II): create 
exec(II): execute program 
fstat(II): status of open 
link(II): link to 


ln(I): link to 

mem(IV): core memory as 
mv({I): move or rename 
od(I): octal dump of 


open(II): open 
passwd(V): password 
read(II): read 
rf£0(IV): RF disk 
rkO(IV): RK disk 
rm(I): remove (delete) 


atf(I): format DECtape 

du(I): find disk usage 

dump disk tc tape 

dump of file 

ed(I): text editor 

editor (loader) 

editor 

e 

EMT traps 

(English) word count 

exec(II): execute program file 
execute program file 

execution 

exit(II): terminate execution 
expander 

exp(III): exponential function 
exponential function 

file contents 

file on IBM 2741 

file status 
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file system format 

file system...check(I): 

file systen: 

file system 

file system 

file system 

file system 
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system(V): file system format 
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concatenate (or print) 
change access mode of 
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set date modified of 
sort(VI): sort a 

sum(I): sum 
tapO,...,tap7(IV): DECtape 
unlink(II): remove (delete) 
du(I): 
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brt1,brt2(VII): B start and 
ftoa(III): convert 
atof(III): convert ASCII to 


fptrap(III): 

form(I): generate 

atf(I): 

rkf£(1): 

roff(I): run off 

bppt(V): binary paper tape 
directorv(V): directory 


file system(V): file system 
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libf(VII): standard 
for(I): compile 
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moo(VI): the 
ttt(VI): the 
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get(III): 
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files 
files...cat(I): 
files.,..chmod(I): 
files 
file...smdate(ITI): 
file 
file 
file 
file 
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find 
find 
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file 
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disk space 

name of terminal 

find read or write pointer 
find undefined symbols 
find(I): find file with given name 
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floating to ASCII 

floating : 
floating-point simulator. 
for(I): compile Fortran program 
fork(II): create new process 
form letter 

format DECtape 

format RK disk 

(format) text 

format 

format 

format 

form(I): generate form letter 
Fortran compiler passes 
Fortran library 

Fortran program 


fptrap(III): floating-point simulator 


free disk space 
from tape 


fstat(II): status of open file 
ftoa(III): convert floating to ASCII 
function 


£1,£2,£3,f4(VII): Fortran compiler passes 


game of black jack 

game of chess 

game of MOO 

game of tic-tac—toe 
generate form letter 

get character 

get date and time of day 
get (English) word count 
get file status 

get file status 

get time information 
get time of year 

get typewriter mode 

get user ID 

get(III): get character 
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find(1I): find’ file with 
hup(T):. 
pr(I): print file with 


type(i): print fiie on 
getuid(II): get user 
setuid(II): set user 
uids(V): map names to user 


ilgins(II}:; catch 
core(V):; core 

tm(I): get time 
utmp(V): logged-in user 
intr(II): catch or 
quit(II): catch or 

. mkfs(I); 


init(VII): 


ilgins(II): catch illegal 
itoa(III): convert 
atoi(III): convert ASCII to 
dsw(I): delete files 
bilib(VII): B 

sh(I): command 


intr(I1I): catch or inhibit 


bj(VI): the game of black 


kbd(VII):; map of TTY 37 


form(I): generate form 
library... 


bilib(VII): B interpreter 
standard assembly—-language 
libb(VII): standard B 
libf(VII): standard Fortran 
ld(I): 

link(II); 

av) 


ls(I): 


ali(VI):; 

rkl(I):; 

a,out(V): assembler and 
ld(I): link editor 
log(III); 

utmp(V): 

logout (VII): logging on and 


getuid(II): get user ID 


given name 


glob(VII): argument expander 


gtty(II): get typewriter mode 


hang up typewriter 


headings 
hup(I): 
IBM 2741 
ID 

ID 


ID’s 


hang up typewriter 


information 

information 

inhibit interrupts 

inhibit quits 

initialize file system 
initializer process 

init(VII): initializer process 
instruction trap 

integer to ASCII 


integer 


interactively 
interpreter library 
interpreter 


interrupts 


intr(II);: 


catch or inhibit interrupts 


itoa(III): convert integer to ASCII 


jack 


kbd(VII): map of TTY 37 keyboard 


keyboard 


lbppt (I): read binary paper tape 
1a(I): link editor (loader) 


letter 
liba( VII) 
libb( VII) 
libf (VII) 
library 


standard assembly—language 
standard B library 
standard Fortran library 


library...liba(VII): 


library 
library 


link editor (loader) 

link to file 

link to file 

link(II); link to file 
list contents of directory 


tT). 
at se 


in 


link to file 


load DEC binary paper tapes 
load disk from tape 
loader output 


(loader ) 


logarithm base e 
logged-in user information 
logging off the system...login, 
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login, logout(VII): 
logging off the system... 
the system,...login, 


mail(I): send 


eee 
kba(VII): 


mem(IV): core 


mesg(I):; permit or deny 


msh( VII): 


chmod(II): 
chmod (I): 


change 
change access 
stty(II): set 
gtty(II): get typewriter 
smdate(II): set date 
moo(VI): the game of 


mount (I): 


wounc ‘ Lij? 


mv(I): 
seek(II); 


tty(I): find 

find file with given 
nm(I): print 
uids(V): map 
fork(II): create 


find(I): 


od(I): 


roff(I): run 
close(II):; close 
fstat(II): status of 
open(II): 


cat(I):; concatenate 
assembler and loader 
chown(II): change 
chown(I):; change 
bppt(V): binary 
Qbppt(I): write binary 
lbppt(I): read binary 
ppt(IV):; punched 


logging on and logging off the system 
log(III): logarithm base e 

login, logout(VII): logging on and 
logout(VII): 
ls(I): list contents of directory 
mail to another user 

mail(I): send mail to another user 
manipulate DECtape 

Map names tO user ID’ s 

map of ASCII 

map Of TTY 37 keyboard 

mem(IV): core memory as file 

memory as file 

mesg(I): permit or deny messages 
mesg(III): print string on typewriter 
messages 
mini Shell 
mkdir(I): create directory 
mkdir(II): create directory 
mkfs(I): initialize file system 
mode of file 

mode of files 

mode of typewriter 


mode 

modified of file 

MOO 

moo(VI). the game of MOO 


mount detachable file system 
mount file system 

mount(I): mount detachable file system 
mount(II): mount file system 
move or rename file 

move read or write pointer 
msh(VII):; mini Shell 

mv(I):; move or rename file 
name of terminal 

name 

namelist 

names to user ID’s 

new process 

nm(I): print namelist, 

octal dump of file 

od(I): octal dump of file 
off (format) text 

open file 

open file 

open file 

open(II): open file 

(or print) files 
output...a.out(V); 

owner of file 

owner of files 

paper tape format 

paper tape 

paper tape 

paper tape 
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logging on and logging off 


dli(VI): load DEC binary 
a@pt(VI): read DEC ASCII 
as2(VII): 
Fortran compiler 


passwd(v) 

mesg(I): 
or write 
or write 


~~ 


seek(II); 
tell(II); 


Le oe ae pie O50 


move read 


cal({VI) 

type(T) 

pr(1) 
concatenate (or 
nm(I): 
mesg(III): 
time(III): 
bproc(VII): 
fork(II): create new 
init(VII): initializer 
rele(II): release 
wait(II): wait for 
break(II): set 
exec(II): execute 
b(I): compile B 
compile Fortran 


oe 


cat(I): 


for(T); 


peetry): 


catch or inhibit 
lbppt (I): 

apt (VI): 
read(II): 
seek(II); move 
tell(II): find 


quit (i) 


boot(I): 
rele(II): 


strip(I): remove symbols, 
ttyO,...,tty5(IV): 
umount(I): dismount 
rmdir(I): 

rm(I): 

unlink(II): 

strip(I): 

mv(I): move or 


rew(I1): 
rfO(IV): 

rkO(IV): 
rk£(1): format 


assembler’s._ 


boot .. 


paper tapes 

paper tapes 

pass 2 
passes...f1,£2,£3,f4(VII): 
passwd(V): password file 
password file 

permit or deny messages 


pointer 

pointer 

ppt(IV): punched paper tape 
pr(I): print file with headings 


print calendar 

print file on IBM 2741 
print file with headings 
print) files 

print namelist 

print string on typewriter 
print time 

procedure 

process 

process 

processor 

process 

program break 

program file 

program 

program 

ptime(III): print time 
punched paper tape 
putc(III); 
quit(II): 
quits 
read binary paper tape 

read DEC ASCII paper Eepes 
read file 

read or write pointer 

read or write pointer 
read(II): read file 

reboot system 

release processor 

rele(II): release processor 
relocation bits 

remote typewriter 

removable file system 

remove (delete) directory 
remove (delete) file 

remove (delete) file 

remove symbols, relocation bits 
rename file 

rew(I): rewind DECtape 

rewind DECtape 

RF disk file 


catch or inhibit quits 


rfO(IV): RF disk file 

RK disk file 

RK disk 

rkd(I): dump disk to tape 
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write character or word 


tabs(VII) 
setuid(II) 


msh(VII): mini 


fptrap(III): floating-point 
sin(III): 


sort(VI): 


a@f(I): find free disk 
liba(VII): 
libb(VII): 
libf(VII):; 

brt1,brt2(VII): B 


fstat(II); 
stat(I): get file 
stat(II): get file 


tabs(VII): set tab 
mesg(III): print 


suftab(VII): roff’s 


sum(I); 


su(I): become 
basic(VI): DEC 


ab(I): 

strip(I): remove 

un(I): find undefined 
file system(V): file 
stime(II): set 

boot(I): reboot 

check consistency of file 


rkf£f(I): format RK disk 

rk1(I): load disk from tape 
rkO(IV): RK disk file 

rmdir(I): remove (delete) directory 
rm(I): remove (delete) file 
roff(I): run off (format) text 
roff’s suffix table 

run off (format) text 

sdate(I): adjust date and time 
seek(II): move read or write pointer 
send mail to another user 

set date modified of file 

set mode. of typewriter 

set program break 

set system time 

set tab stops on typewriter 

set user ID 
setuid(II); 
Shell 
sh(I): command interpreter 

simulator 

sine, cosine 

sin(III): sine, cosine 

smdate(II): set date modified of file 
sort a file 

sort(VI): sort a file 

space 

standard assembly-—language library 
standard B library 

standard Fortran library 

start and finish 

stat(I): get file status 

stat(II): get file status 

status of open file 

status 

status 

stime(II): set system time 

stops on typewriter 

string on typewriter 

strip(I): remove symbols, relocation bits 
stty(II): set mode of typewriter 

suffix table 

suftab(VII): roff’s suffix table 

su(I); become super-user 

sum file 

sum(I): sum file 

super-user 

supplied BASIC 

switch(III): transfer depending on value 
symbolic debugger 

symbols, relocation bits 

symbols 

system format 

system time 

system 

system,..check(I): 


set user ID 
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and logging off the 
mkfs(I): initialize file 
mount detachable file 
mount (II): mount file 
dismount removable file 
umount (II): dismount file 
a file 
who(I)}): who is on the 
tabs(VII): set 
suftab(VII); roff’s suffix 
bppt(V): binary paper 
dbppt(I): write binary paper 
lbppt (I): read binary paper 
ppt(IV): punched paper 
rkd(I): dump disk to 

rkl(I): load disk from 

load DEC binary paper 
dpt(VI):; read DEC ASCII paper 


tty(I): find name of 
exit(II): 
ed(I): 


roff(I): run off (format) 


ttt(VI): the game of 
tm(I): get 
date(I): get date and 


time(II): get 
ctime(III): ¢onvert 


ptime(III): print 
sdate(I): adjust date and 
stime(II): set system 


switch(III):; 
catch illegal instruction 
cemt (II): catch EMT 


kba( VII): map of 


gtty(II): get 

hup(I): hang up 

mesg(III): print string on 
stty(II): set mode of 
tabs(VII): set tab stops on 
tty(IV): console 
ttyO,...,tty5(IV):; remote 


un(I): find 


system,..login, logout(VII): logging on 
system 

system,..mount(I): 

system 

system...umount(I): 

system 

system(V): file system format 

system 

tab stops on typewriter 

table 

tabs( VII); 
tape format 
tape 

tape 

tape 

tape 

tape 
tapes...dli(VI): 
tapes . 
tap(I): manipulate DECtape 
tapO,...,tap7(IV):; DECtape file 
tell(II): find read or write pointer 
terminal 

terminate execution 

text editor 

text 

tic-tac-—toe 

time information 

time of day 

time of year 

time to ASCII 

time(II): get time of year 

time 

time 

time 

tm(I): get time information 
transfer depending on value 
trap. e eilgins( II): 

traps : 

ttt(VI): the game of tic-—tac-—toe 
TTY 37 keyboard 

tty(I): find name of terminal 
tty(IV): console typewriter 
ttyO,...,tty5(IV): remote typewriter 
type(I): print file on IBM 2741 
typewriter mode 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

uids(V): map names to user ID’s 


set tab stops on typewriter 


umount(I): dismount removable file system 


umount(II):; dismount file system 
undefined symbols 
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a@u(i): find disk 
getuid(II): get 
setuid(II): set 

uids(V): map names to 

utmp (Vv) : logged-in 

mail(I): send mail to another 
write(1): write to another 


transfer depending on 
wait(II): 


who(I): 


find(I): find file 
pr(I): print file 
we(I): get (English) 
putc(II1l): write character or 
chdir(I): change 
chdir(I1I); change 
dbppt (I): 

putc(III): 

seek(II): move read or 
tell(Ii): find read or 
write(I): 


time(Ii): get time of 

as2(VII): assemblers pass 

type(I): print file on IBM 
Vv 


kbd (VII): map of TTY 


un(I): find undefined symbols 
unlink(II): remove (delete) file 
usage 

user ID 

user ID 

user 
user 
user 
utmp(V): logged-in user information 
value...switch(III): 

wait for process 

wait(II): wait for process 

we(I): get (English) word count 
who is on the system 

who(I): who is on the system 

with given name 

with headings 

word count 

word 

working directory 

working directory 

write binary paper tape 

write character or word 

write pointer 

write pointer 

write to another user 

write(I): write to another user 
year 

2 

2741 

37 keyboard 


information 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


AR (I) 


ar -- archive 
ar key afile name, ..- 


ar maintains groups of files combined into a sin- 
gle archive file. Its main use is to create and 
update library files as used by the loader, It 
can be used, though, for any similar purpose, 


key is one character from the set drtux, option-— 
ally concatenated with vy. afile is the archive 
file, The names are constituent files in the 
archive file. The meanings of the key characters 
are: 


dad means delete the named files from the archive 
file, 


x means replace the named files in the archive 
file. If the archive file does not exist, r will 
create it. If the named files are not in the 
archive file, they are appended, 


& prints a table of contents of the archive file, 
If no names are given, all files in the archive 
are tabled. If names are given, only those files 
are tabled, 


u is similar to r except that only those files 
that have been modified are replaced, If no 
names are given, all files in the archive that 
have been modified will be replaced by the modi- 
fied version. 


x will extract the named files, If no names are 
given, all files in the archive are extracted, 
In neither case does x alter the archive file, 


vy means verbose, Under the verbose option, ar 
gives a file-by-file description of the making of 
a new archive file from the old archive and the 
constituent files, The following abbreviations 
are used: 


copy 
append 
delete 
replace 
extract 


IX 15 lata 1a 


/tmp/vtma, vtmb ... temporary 
ld 


"Bad usage”, “afile -- not in archive format” 
cannot open temp file , name -- cannot open , 
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“name -- phase error” > "name -- cannot create” 
wno archive file” 7 “cannot create archive file 
“name -- not found", 


a 
’ 


BUGS Option 1 (table with more information) should be 
implemented, 


There should be a way ee specify the placement of 
Fal ote] 


a new 2.6.35 on archive, Currentiy, it is 


placed at the end, 


OWNER ken, dmr 
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NAME as -- assembler 
SYNOPSIS as name, ... 
DESCRIPTION as assembles the concatenation of name,, .... as 


Ts based on the DEC-provided assembler PAL-iiR 
[references], although it was coded locally. 
Therefore, only the differences will be recorded, 


Character changes are: 


for use 
e * 
# $ 
; / 


In as, the character ";" is a logical new line; 
several operations may appear on one line if 
separated by ; . Several new expression opera-— 
tors have been provided: 


\> | right shift (logical) 

\< left shift 

¥ multiplication 

if division p - 
4 remainder (no longer means register ) 
! one’s complement 

i) parentheses for grouping 


result has value of left, type of right 


For example location 0 (relocatable) can be writ- 
ten Q . 3 another way to denote register 2 is 
2r0, 


All of the preceding operators are binary; if a 
left operand is missing, it is taken to be 0. 
The ! operator adds its left operand to the 
one’s complement of its right operand, 


There is a conditional assembly operation code 
different from that of PAL-11R (whose condition- 
als are not provided): 


.if expression 


eendif 


If the expression evaluates to non-zero, the sec-— 
tion of code between the .if and the 3 endif 

is assembled; otherwise it is ignored. if s 
may be nested, 


Temporary labels like those introduced by Knuth 
[reference] may be employed. A temporary label 
is defined as follows: 
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ns 


where n is a digit 0 ... 9. Symbols of the form 
nf refer to the first label n: following the 
use of the symbol; those of the form nb refer 
to the last n: . The same n may be used many 
times, Labels of this form are less taxing both 
on the imagination of the programmer and on the 
Symbol, able epace of the assembler, 
The PAL—-11R opcodes ",eot” and “,end” are redun- 
dant and are omitted, 


The symbols 


rO .e. £5 
sp 
pe 


ac 

mq ia 
div Sos Mende oe 1. clei eg? 
mul ~ 


lsh 
ash , 
nor.” 
csw 


are predefined with appropriate values. The sym- 
bol csw refers to the console switches, oe 

is the relocation constant and is added to each 
relocatable symbol; normally it is 40000(8); it 
may be changed to assemble a section of code at a 
location different from that in which it will be 
executed, 


It ig illegal to assign a value to “ " less than 
its current value. 


The new opcode "sys" is used to specify system 
calls, Names for system calls are predefined, 
See the section on system calls for their names, 


Strings of characters may be assembled in a way 
more convenient than PAL-11’s .ascii operation 
(which is, therefore, omitted), Strings are | 

included between the string quotes < and >: 


<here is a string> 


Escape sequences exist to enter non graphic and 
other difficult characters. These sequences are 
also effective in single and double character 
constants introduced by single (‘’) and double (”) 
quotes respectively. : 
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FILES 


SEE ALSO 


DIAGNOSTICS 


AS (1) 


use for 
\n newline (012) 
\O NULL (000) 


> 
\t TAB (011) 
\ 


The binary output of the assembier is piaced on 
the file a.out in the current directory. a,out 
also contains the symbol table from the assembly 
and relocation bits. The output of the assembler 
is executable immediately if the assembly was 
error-free and if there were no unresolved exter- 
nal references, The link editor 1d may be used 
to combine several assembly outputs and resolve 
global symbols, 


The multiple location counter feature of PAL11R 
is not supported, 


The assembler does not produce a listing of the 
source program, This is not a serious drawback; 
the debugger db discussed below is sufficiently 
powerful to render a printed octal translation of 
the source unnecessary. 


/etc/as2 pass 2 of the assembler 
a.tmp1 temporary 

a,tmp2 temporary 

a.tmp3 temporary 

a,out object 


ld, nm, sh, un, db, a.out (format of output) 


When an input file cannot be read, its name fol- 
lowed by a question mark is typed and assembly 
ceases, 


When syntactic or semantic errors occur, a 
single-character diagnostic is typed out together 
with the line number and the file name in which 
it occurred, Errors in pass 1 cause cancellation 
of pass 2. The possible errors are: 


parentheses error 

parentheses error 

Indirection ("*") used illegally 

error in Address 

Branch instruction has too remote an ad- 
dress 

error in Expression ee 

error in local ( F or b ) type symbol 
Garbage (unknown) character 

Multiply defined symbol as label 

Qdd-- word quantity assembled at odd 


COZOMWM WY x r~ 
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address ee 

Phase error-- . different in pass 2 from 
pass 1 value 

Relocation errer 

Undefined symbol 

syntaX error 


as) 


t 
‘ 


CG 


A 
oJ 


BUGS Symbol table overflow is not checked, 


OWNER amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 
BUGS 


OWNER 


B (I) 


B -—— language 
sh re /usr/b/re name 


B is a language suitable for system programming. 
It is described is a separate publication B 
reference manual, 


The canned shell sequence in /usr/b/re will com— 

pile the program name.b into the executable file 

a,out, It involves running the B compiler, the B 
assembler, the assembler and the link editor. 

The process leaves the files name,i and name.s in 


the current directory. 
name.b, name.i, name,.s, 


fetc/be, /etc/ba, /etc/brt1, /etc/brt2, 
/etc/bilib, /etc/libb.a, B ref erence manual. 


see B reference manual 
There should be a B command, 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


BAS (I) 


bas -- basic 
bas [file] 


bas is a dialect of basic, If a file argument is 
provided, the file is used for input before the 
console is read, 


statement 
integer statement 


Integer numbered statements (Known as internal. 
statements) are stored for later execution. They 
are stored in sorted ascending order, Non- 
numbered statements are immediately executed, 

The result of an immediate expression statement 
(that does not have ‘=’ as its highest operator) 
is printed, 


Statements have the following syntax: (expr is 
short for expression) 


expr 
The expression is executed for its side 
effects (assignment or function call) or 
for printing as described above, 


done 
Return to system level, 


draw expr expr expr 
draw is used to draw on a 611-—type storage. 
scope through a TSP-1 plotter interface, 
The coordinates of the scope face are zero 
to one in both the x and y directions, 
(Zero,zero being the lower left corner. ) 
The expressions are evaluated and designat- 
ed X, Y, and 2. A line is drawn from the 
previous X, Y to the new X, Y. If Z is 
non-zero, the line is visible, otherwise 
the.line is invisible, 


for name = expr expr statement 
for name = expr expr 
next 


The for statement repetatively executes a 
statement (first form) or a group of state- 
ments (second form) under control of a 
named variable, The variable takes on the 
value of the first expression, then is 
incremented by one on each loop, not to 
exceed the value of the second expression. 
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goto expr 
The expression is evaluated, truncated to 
an integer and execution goes to the 
corresponding integer numbered statment, 
If executed from immediate mode, the inter- 
nal statements are compiled first. 


if expr statement 
MAA ak ake am aAN eS ie a 
L£11—S BDLACTCINGDI Lo 


x 
evaluates to non—zero, 


list [expr [expr]] 
list is used to print out the stored inter- 
nal statements. If no arguments are given, 
all internal statements are printed. If 
one argument -is given, only that internal 
statement is listed, If two arguments are 
given, all internal statements inclusively 
between the arguments are printed, 


print expr 
The expression is evaluated and printed. 


return expr 
The expression is evaluated and the result 
is passed back as the value of a function 
call, ; 


run 
The internal statements are compiled. The 
symbol table is re-initialized, The random 
number generator is re-set, Control is 
passed to the lowest numbered internal 
statement, 


Expressions have the following syntax: 


name 
A name is used to specify a variable, 
Names are composed of a letter (’a’ - ’z’) 


followed by letters and digits. The first 
four characters of a name are significant. 


number 
A number is used to represent a constant 
value. A number is composed of digits, at 
most one decimal point (°.’) and possibly a 
scale factor of the form e digits or e- 
digits. 


{ expr ) 
Parentheses are used to alter normal order 
of evaluation, 


expr op expr 
Common functions of two arguments are 
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abbreviated by the two arguments separated 
by an operator denoting the function. A 
complete list of operators is given below, 


expr ( [expr [, expr ...]] ) 
Functions of an arbitrary number of argu- 
ments can be called by an expression fol- 
lowed by the arguments in parentheses 
separated by commas. The expression evalu- 
ates to the line number of the entry of the 
function in the internally stored state- 
ments, This causes the internal statements 
to be compiled. If the expression evalu- 
ates negative, an builtin function is 
called, The list of builtin functions 
appears below, 


name [ expr [, expr ...] 
Arrays are not yet implemented, 


The following is the list of operators: 


= is the assignment operator, The left 
operand must be a name or an array element, 
The result is the right operand, Assign- 
ment binds right to left, all other opera- 
tors bind left to right. 


& | 
& (logical and) has result zero if either 
of its arguments are zero, It has result 
one if both its arguments are non-zero, |} 
(logical or) has result zero if both of its 
arguments are zero, It has result one if - 
either of its arguments are non-zero, 


<< <= > >= == 
The relational operators (< less than, <= 
less than or equal, > greater than, >= 
greater than or equal, == equal to, <> not 
equal to) return one if their arguments are 
in the specified relation. They return 
zero otherwise. Relational operators at 
the same level extend as follows: ab>c is 
the same as a>b&b>c. 


+ 
Add and subtract, 


ane 
Multiply and divide. 


Exponeniation. 
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The following is a list of builtin functions: 


arg 
Arg(i) is the value of the ith actual 
parameter on the current level of function 
call. 


Exp(x) is the exponential function of x. 
Log(x) is the logarithm bas e of x. 
Sin(x) is the sine of x (radians). 


Cos(x) is the cosine of x (radians), 


atn 
Atn(x) is the arctangent of x. (Not imple 
ment ed, ) 


rnd 
Rnd() is a uniformly distributed random 
number between zero and one, 


expr 
Expr() is the only form of program input. 
A line is read from the input and evaluated 
as an expression. The resultant value is 


returned, 
int 
Int (x) returns x truncated to an integer, 
FILES /tmp/btma, btmb ... temporary 
SEE ALSO -~ 
DIAGNOSTICS Syntax errors cause the incorrect line to be 


typed with an underscore where the parse failed, 
All other diagnostics are self explanatory. 


BUGS Arrays [] are not yet implemented. In general, 
program sizes, recursion, etc are not checked, 
and cause trouble. 


OWNER , ken 
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NAME bed —- binary coded decimal conversion 
SYNOPSIS bed [ string ] 
DESCRIPTION bed will convert a string into GECOS card code, 


If no argument string is provided, bed will read 
a line and convert it, 


SEE ALSO a 
DIAGNOSTICS -- 
BUGS -- 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


BOOT (TI) 


boot --— reboot system 
etc/boot 


boot logically a command, and is kept in /etc 
only to lessen the probability of its being in- 
voked by accident or from curiosity. It reboots 
the system by jumping to the read-only memory, 


ahianh anntatine a Aiek hont nrocram 
West wid New WV ES er 4 DA te — wt he eI Pet Ne pews > eure 


boot procedure 


Should obviously not be executable by the general 
user, Also, it should reboot in a more direct 
manner, The mechanism invoked by jumping to the 
ROM loader is sensitive to the contents of the 
console switches, which makes the whole procedure 
even more dangerous, 


Rather than jumping to the ROM, boot should simu- 
late the ROM action with 173700 in the switches, 
In this manner, It may be used when the switches 
are not set, and even in installation without a 
ROM. 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CAT (TI) 


cat -- concatenate and print 
file, Sate 


cat 
Cat reads each file in sequence and writes it on 
the standard output stream, Thus: 


cat file 
is about the easiest way to print a file, Also: 
gat filel file2 >file3 
is about the easiest way to concatenate files, 


If no input file is given cat reads from the 
standard input file, 


pr, Cp 
none; if a file cannot be found it is ignored, 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CHDIR (I) 


chdir -— change working directory 

chdir directory 

directory becomes the new working directory, 
Because a new process is created to execute each 
command, chdir would be ineffective if it were 
written as a normal command. It is therefore 


recognized and executed by the Shell. 


sh 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


CHECK (I) 


check -~- file system consistency check 


check [ filesystem [ blockno, ... ] ] 


check will examine a file system, build a bit map 
of used blocks, and compare this bit map against 
the bit map maintained on the file system, If 
the file system is not specified, a check of both 
/dev/rf£O and /dev/rkO is performed, Output in- 
cludes the number of files on the file system, 
the number of these that are ‘large’, the number 
of used blocks, and the number of free blocks, 


/dev/rf0, /dev/rko 
find 


Diagnostics are produced for blocks missing, 
duplicated, and bad block addresses, Diagnostics 
are also produced for block numbers passed as 
parameters, In each case, the block number, 
i-number, and block class (i = inode, x indirect, 
£ free) is printed, 


The checking process is two pass in nature, If 
checking is done on an active file system, ex- 
traneous diagnostics may occur, 


The swap space on the RF file system is not ac-— 
counted for and will therefore show up as ‘miss-— 
ing’. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CHMOD (I) 


chmod -— change mode 
chmod octal file, eee 


The octal mode replaces the mode of each of the 
files, The mode is constructed from the OR of 
the following modes; 


O41 write for non-owner 
O02 read for non-owner 
04 write for owner 

10 read for owner 

20 executable 

40 set-UID 


Only the owner of a file may change its mode, 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CHOWN (I) 


chown -- change owner 
chown owner file, ee 
owner becomes the new owner of the files, The 


owner may be either a decimal UID or a name found 
in /etc/uids. 


ge 
er, “It ‘is illegal to change the Owner of a 
file with the set-—user-ID mode, 
/etc/uids 


stat 
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NAME cmp --— compare two files 
SYNOPSIS cmp file, file, 
DESCRIPTION The two files are compared for identical con- 


tents, Discrepancies are noted by giving the 
offset and the differing words. 


FILES -- 

SEE ALSO == 

DIAGNOSTICS Messages are given for inability to open either 
argument, premature EOF on either argument, and 
incorrect usage, 

BUGS If the two files differ in length by one byte, 
the extra byte does not enter into the compari- 
son, 


OWNER amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


cP (TI) 


cp -- copy 


file file file ree 


11 12 21 22 

Files are taken in pairs; the first is opened for 
reading, the second created mode 17, Then the 
first is copied into the second, 


ep file 


cat, pr 


Error returns are checked at every system call, 
and appropriate diagnostics are produced, 


The second file should be created in the mode of 
the first, 


A directory convention as used in mv should ba 
adopted to cp. 


ken, amr 
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NAME 
SYNOPSIS 
DESCRIPTION 


FILES 


DIAGNOSTICS 
BUGS 


OWNER 


DATE (TI) 


date -- print the date 


Gate 


- The current date is printed to the second, 
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NAME 
SYNOPSIS 


DESCRIPTION 


DB (I) 


db -- debug 
ab [ core [ namelist ] ] 


Unlike many debugging packages (including DEC’s 
ODT, on which gb is loosely based) db is not 
loaded as part of the core image which it is used 
to examine; instead it examines files, Typical- 
ly, the file will be either a core image produced 
after a fault or the binary output of the assem- 
bler, Core is the file being debugged; if omit- 
ted “core” is assumed. namelist is a file con- 
taining a symbol table, If it is omitted, a,out 
is the default. If no appropriate name list file 
can be found, db can still be used but some of 
its symbolic facilities become unavailable, 


The format for most db requests is an address 
followed by a one character command, 


Addresses are expressions built up as follows: 


1. A name has the value assigned to it when 
the input file was assembled, It may be 
relocatable or not depending on the use of 
the name during the assembly. 


2. An octal number is an absolute quantity 
with the appropriate value, - 


3. An octal number immediately followed by “r” 
is a relocatable quantity with the ap-— 
propriate value, 


4, The symbol "." andicates the current 
pointer of db. The current pointer is set 
by many db requests, 


5. Expressions separated by "+" or ” ™ (blank) 
are expressions with value equal to the sum 
of the components, At most one of the com- 
ponents may be relocatable, 


6. Expressions separated by "_" form an ex- 
pression with value equal to the difference 
to the components. If the right component 
is relocatable, the left component must be 
relocatable, 

7. Expressions are evaluated left to right, 

Names for registers are built in: 


EO" gex« PS 
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ac 
mq 


These may be examined. Their values are deduced 
from the contents of the stack in a core image 
file. They are meaningless in a file that is not 
a core image, 


If no address is given for a command, the current 
address (also specified by “) is assumed, In 
general, . points to the last word or byte 
printed by db. 


There are db commands for examining locations 
interpreted as octal numbers, machine instruc- 
tions, ASCII characters, and addresses, For 
numbers and characters,.either bytes or words may 
be examined, The following commands are used to 
examine the specified file, 


/ The addressed word is printed in octal, 
\ The addressed byte is printed in octal, 


The addressed word is printed as two ASCII 
characters, 


* The addressed byte is printed as an ASCII 
character, ; 


* The addressed word is multiplied by 2, then 
printed in octal (used with B. programs, 
whose addresses are word addresses), 


oo] 


The addressed word is interpreted as a 
machine instruction and a symbolic form of 
the instruction, including symbolic ad- 
dresses, is printed, Usually, the result 
will appear exactly as it was written in 
the source program, 


& The addressed word is interpreted as a sym- 
bolic address and is printed as the name of 
the symbol whose value is closest to the 
addressed word, possibly followed by a 
signed offset, 


<nl> (i. e., the character "new line”) This 
command advances the current location 
counter "," and prints the resulting loca- 
tion in the mode last specified by one of 
the above requests, 


This character decrements ",.” and prints 
the resulting location in the mode last 
selected one of the above requests, It is 
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a converse to <nlb>, 


It is illegal for the word-oriented commands to 
have odd addresses, The incrementing and decre— 
menting of . done by the <nl> and requests is 
by one or two depending on whether the last com- 
mand was word or byte oriented, 


The address portion of any of the above commands . 
may be followed by a comma and then by an expres-— 
sion, In this case that number of sequential 
words or bytes specified by the expression is 
printed, - is advanced so that it points at 
the last thing printed, 


There are two commands to interpret the value of 
expressions, 


= When preceded by an expression, the value 
of the expression is typed in octal. When 
not preceded by an expression, the value of 
» is indicated, This command does not 
change the value of .. 


ue 


An attempt is made to print the given ex- 
pression as a symbolic address, If the 
expression is relocatable, that symbol is 
found whose value is nearest that of the 
expression, and the symbol is typed, fol- 
lowed by a sign and the appropriate offset, 
If the value of the expression is absolute, 
a symbol with exactly the indicated value 
is sought and printed if found; if no 
matching symbol is discovered, the octal 
value of the expression is given. 


. The following command may be used to patch the 


file being debugged. 


! This command must be preceded by an expres-— 
sion. The value of the expression is 
stored at the location addressed by the 
current value of .. The opcodes do not 
appear in the symbol table, so the user 
must assemble them by hand, 


The following command is used after a fault has 
caused a core image file to be produced, 


$ causes the contents of the general regis— 
ters and several other registers to be 
printed both in octal and symbolic format, 
The values are as they were at the time of 
the fault. 
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DIAGNOSTICS 


BUGS 


OWNER 


DB (I) 


The only way to exit from db is to generate an 
end of file on the typewriter (EOT character), 


_—— . 
as; core for format of core image. 


founda” if the first argument cannot be 


rwise ? 


Really, db should know about relocation bits, 
floating point operations, and PpP11/45 instruc— 


tions, 


dmr ‘ 
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DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 
BUGS 


OWNER 


DBPPT (I) 


dbppt -- dump binary paper tape 

dbppt name [ output ] 

dbppt produces binary paper tape in UNIX standard 
format, which includes checksums and a zero- 
suppression feature, File name is dumped; if the 


Output argument is not given, output goes to 
Jdev/ppt. 


/dev/ppt 


lbppt to reload the tapes. bppt for binary paper 
tape format. 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


pe (I) 


de -- desk calculator 
de 


gc is an arbitrary precision integer arithmetic 
package. The overall structure of de is a stack-~ 
ing (reverse Polish) calculator, The following 
constructions are recognized by the calculator: 


number 
The value of the number is pushed on the 
stack. If the number starts with a zero, it 
is taken to be octal, otherwise it is decimal. 


+ — * 

" “The top two values on the stack are added (+), 
subtracted (=), multiplied (*), divided (/), 
or remaindered (%). The two entries are 
popppea off of the stack, the result is pushed 
on the stack in their place, 


x 


The top of the stack is popped and stored into 
a register named x, where x may be any charac-— 
ter, 


The value in register x is pushed on the 
stack, The register x is not altered, 


a 
The top value on the stack is pushed on the 
stack, Thus the top value is duplicated, 
Bp 
The top value on the stack is printed in de- 
cimal, The top value remains unchanged. 
£ 
All values on the stack are popped off and 
printed in decimal, 
= 
All values on the stack are popped. 
= § 
exit, 
h 
print brief synopsis of commands to dc, 
new-line 
space 


ignored, 


An example to calculate the monthly, weekly and 
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FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


hourly rates for a $10,000/year salary. 


10000 

100% {now in cents) 

dsa (non-destructive store) 
12/ (pennies per month) 
1a52/ (pennies per week) 

a10* (deci-pennies per week) 
375/ (pennies per hour) 

£ (print all results) 

(3) 512 

(2) 19230 

(1) 83333 


? (x) for unrecognized character x, 
% doesn’t work correctly. 


ken 
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DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


DF (I) 


af -— disk free 
‘at, [ filesystem ] 


g£ prints out the number of free blocks available 


on a file system, If the file system is unspeci- 
fied, the free space on /dev/rf0O and /dev/rk0O is 
printed, 

/dev/rfQ, /dev/rkO 


check 


ken, dmr 
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DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS . 


OWNER 


psw (I) 


dsw --— delete interactively 
dsw [ directory ] 


For each file in the given directory Ca if not 
specified) dsw types its name, If y is typed, 
the file is deleted; if x , dsw exits; if any- 
thing else, the file is not removed, 


The name “dsw" is a carryover from the ancient 
past. Its etymology is amusing but the name is 
nonetheless ill-advised. 


dmr, Ken 
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NAME atf --— DECtape format 

SYNOPSIS etc/dtft 

DESCRIPTION at£ will write timing tracks, mark tracks ates 
block numbers on a virgin DECtape, The format is 


DEC standard of 578 blocks of 256 words each. 
The end zones are a little longer than standard 
DEC. 


Before use, the tape to be formatted should be 
mounted on drive 0. The ‘wall’ and ‘wtm’ 
switches should be enabled. After the tape is 
formatted, the switches should be disabled to 
prevent damage to subsequent tapes due to a con- 
troller logic error, 


FILES —_ 

SEE ALSO sdate 

DIAGNOSTICS "2" ais typed for any error detected, 

BUGS This program does physical I/O on drive 0, The 


processor priority is set very high due to very 
stringent real time requirements, This means 
that all time sharing activities are suspended 
during the formatting (about 1,5 minutes) The 
real time clock will also be slow. 


OWNER ken 


41/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


DU (TI) 


du -— summarize disk usage 
du [Cz=-s] [( -a] [ name... ] 


du gives the number of blocks contained in all 
files and (recursively) directories within each 
specified directory or file name. If name is 
missing, , is used, 


The optional argument -s causes only the grand 
total to be given. The optional argument -a 
causes an entry to be generated for each file. 
Absence of either causes an entry to be generated 
for each directory only. 


A file which has two links to it is only counted 
once, 


/ 


_—— 


Files at the top level (not under -a option) are 
not listed, 


Removable file systems do not work correctly 
since i-numbers may be repeated while the 
corresponding files are distinct. Du should 
maintain an i-number list per root directory 
encountered, 


amr 
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NAME 
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DESCRIPTION 


ED (I) 


ed -- editor 
ed [ name ] 


ed is the standard text editor. ed is based on 
QED [reference] but is fully if succinctly 
described here. Differences between ed and QED 
are also noted to simplify the transition to the 
bees poveriul. editer, 

If the optional argument is given, ed simulates 
an e command on the named file; that is to say, 
the file is read into ed’s buffer so that it can 
be edited. 


ed operates on a copy of any file it is editing; 
changes made in the copy have no effect on the 
file until an explicit write (w) command is 
given. The copy of the text being edited resides 
in a temporary file called the buffer. There is 
only one buffer. 


Commands to ed have a simple and regular 
structure: zero or more addresses followed by a 
single character command, possibly followed by 
parameters to the command. These addresses 
specify one or more lines in the buffer. Every 
command which requires addresses has default 
addresses, so that the addresses can often be 
omitted, 


In general only one command may appear on a line, 
Certain commands allow the input of text. This 
text is placed in the appropriate place in the 
buffer. While ed is accepting text, it is said 
to be in input mode. In this mode, no commands 
are recognized; all input is merely collected, 
Input mode is left by typing a period (.) alone 
at the beginning of a line, 


ed supports a limited form of regular expression 
notation. A regular expression is an expression 
which specifies a set of strings of characters, 
A member of this set of strings is said to be 
matched by the regular expression. The regular 
expressions allowed by ed are constructed as 
follows: 


1, An ordinary character (not one of those 
discussed below) is a regular expression 
and matches that character, : 


2. A circumflex (~) at the beginning of a reg- 
ular expression matches the null character 
at the beginning of a line, 
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3. A currency symbol ($) at the end of a regu- 
lar expression matches the null character 
at the end of a line, 


4. A period (.) matches any character but a 
new—line character, 


5. A regular expression followed by an aster-— 
isk (*) matches any number of adjacent 
occurrences (including zero) of the regular 
expression it follows, 


6. A string of ‘characters enclosed in square 
brackets ([])‘niatches any character in the 
string but no others, If, however, the 
first character of the string is a circun- 
flex (~) the regular expression matches any 
Character but new-line and the characters 
in the string. 


7. The concatenation of regular expressions is 
a regular expression which matches the con-— 
catenation of the strings matched by the 
components of the regular expression. 


8, The null regular expression standing alone 
is equivalent to the last regular expres-— 
sion encountered, 


Regular expressions are used in addresses to 
specify lines and in one command (s, see below) 
to specify a portion of a line which is to be 
replaced, 


If it is desired to use one of the regular ex-— 
pression metacharacters as an ordinary character, 
that character may be preceded by \. This also 
applies to the character bounding the regular 
expression (often / ) and to \ itself, 


Addresses are constructed as follows. To under- 
stand addressing in ed it is necessary to know 
that at any time there is a current line,. Gen-— 
erally speaking, the current line is the last 
line affected by a command; however, the exact 
effect on the current line by each command is 
discussed under the description of the command, 


1. The character ",” addresses the current 
line, 


2. The character "$" addresses the last line 
of the buffer, 


3. A decimal number n addresses the nth line 
of the buffer, 
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4. A regular expression enclosed in slashes 
"/" addresses the first line found by 
searching toward the end of the buffer and 
stopping at the first line containing a 
string matching the regular expression, If 
necessary the search wraps around to the 
beginning of the buffer, 


5. A regular expression enclosed in quer 
"0" addresses the first line found by. 
searching toward the beginning of the 
buffer and stopping at the first line found 
containing a string matching the regular 
expression. If necessary the search wraps 
around to the end of the buffer, 


ta 


6. An address followed by a plus sign "+" or a 
minus sign - followed by a decimal number 
specifies that address plus (resp. minus) 
the indicated number of lines. The plus 
sign may be omitted, 


Commands may require zero, one, or two addresses, 
Commands which require no addresses regard the 
presence of an address as an error, Commands 
which require the presence of one address all 
assume a default address (often ") but if given 
more than one address ignore any extras and use 
the last given. Commands which require two ad- 
dresses have defaults in the case of zero or one 
address but use the last two if more than two are 
given, 


Addresses are haope from each other typically 
by a comma ( They may also be separated by a. 
semicolon (; ae In this case the current line . 
is set to the the previous address before the 
next address is interpreted. This feature is 
used to control the starting line for forward and 
backward searches ("/", "?"). 


In the following list of ed commands, the default 
addresses are shown in parentheses, The 
parentheses are not part of the address, but are 
used to show that the given addresses are the 
default. 


As mentioned, it is generally illegal for more 
than one command to appear on a line, However 
any command may be suffixed by “p” (for “print’'). 
In that case, the current line is printed after 
the command is complete, 


In any two-address command, it is illegal for the 
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first address to lie after the second address, 


The append command reads the given text and 
appends it after the addressed line, ”. 

is left on the last line input, if there 
were any, otherwise at the addressed line, 
Address O is legal for this command; text 
is placed at the beginning of the buffer. 
(NOTE: the default address differs from 
that of QED.) 


Capese 
<text> 
The change command deletes the addressed 
lines, then accepts input text which re- 
places these lines, » is left at the 
last line input; if there were none, it is 
left at the first line not changed. 


( Ja 

Ye e 
"phe delete command deletes the addressed 
lines from the buffer, - is left at the 
first line not deleted, 


e filename 
The edit command causes the entire contents 
of the buffer to be deleted, and then the 
named file to be read in, . is set to 
the last line of the buffer, The number of 
characters read is typed. 


(1,$)g/regular expression/command 
In the global command, the first step is to 
mark every line which matches the given 
regular expression. Then for every such 
jine, the given command is executed with 
- set to that line. The repeated command 
cannot be a, g, i, or c. 


(.)4 

<text> 
This command inserts the given text before 
the addressed line, . is left at the 
last line input; if there were none, at the 
addressed line. This command differs from 
the a command only in the placement of the 
text. 


Cegendh 
The list command prints the addressed lines 
in an unambiguous way. Non-printing 
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Characters are over-struck as follows: 
char prints 


' bs \ 
tab > 
ret q 
SI z 
so ° 


All characters preceded by a prefix (Es¢) 
cnaracter are printea over-—-str ucK with 
without the prefix. Long lines are folded 
with the sequence \newline. 


(ape JB 
The print command prints the gaaeecaea 
lines, - is left at the last line print- 
ed, 


The quit command causes ed to exit. No 
automatic write of a file is done, 


($)r filename 
The read command reads in ‘the given file 
after the addressed line, If no file name 
is given, the file last mentioned in e, r, 
Or w commands is read, Address "oO" is 
legal for x and causes the file to be read 
at the beginning of the buffer, If the 
read is successful, the ntmber of charac-— 
ters read is typed. . is left at the 
last line of the file. 


(.,.)s/regular expression/replacement/ 

The substitute command searches each ad- 
dressed line for an occurence of the speci- 
fied regular expression. On each line in 

‘whith a match is found, the first (and only 
first, compare QED) matched string is re- 
placed by the replacement specified, It is 
an error for the substitution to fail on 
all addressed lines, Any character other 
than space or new-line may be used instead 
of "/" to delimit the reqular expression 
and the replacement. - is left at the 
last line substituted, 


The ampersand e appearing in the replace- 
ment is replaced by the regular expression 
that was matched, The special meaning of 

"s" in this context may be suppressed by 
preceding it by "\". 


(1,$)w filename 
The write command writes the addressed 
lines onto the given file. If no file name 
is given, the file last named in e, r, or w 
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commands is written. ".” is unchanged, If 
the command is successful, the number of 
characters written is typed, 


($)= 
The line number of the addressed line is 
typed. . is unchanged by this command. 


1UNIX command ae 
The remainder of the line after the “!” is 
sent to UNIX to be interpreted as a com-— 
mand, - is unchanged, 


<newline> i - 
A blank line alone is equivalent to .+ip ; 
it is useful for stepping through text. 


Ed can edit at most 1500 lines and the maximum 
size of a line is 256 characters, The differ-— 
ences between ed and QED are: 


1, There is no "\f" character; input mode is 
left by typing . aloneon a line, 


2. There is only one buffer and hence no "\b" 
stream directive. 


3. The commands are limited to: 


acdegilpqrsw 
where eis new, 


4. The only special characters in regular 
expressions are; 


ian ae ae 


which have the usual meanings. However, 

ana "$" are only effective if they are 
the first or last character respectively of 
the regular expression. Otherwise suppres-— 
sion of special meaning is done by preced— 
ing the character by "\", which is not oth- 
erwise special. 


5. In the substitute command, only the left- 
most occurrence of the matched regular 
expression is substituted, 


7. The a command has a different default ad- 
dress, 


FILES /tmp/etma, etmb, ... temporary ere 
/etc/msh is used to implement the ! command. 
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SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


ED (1) 


2" for any error 

ed is used as the shell for the editing system. 
It has the editing system UID buiit in and if 
invoked under this UID will give slightly dif- 
ferent responses, This is a little kludgy. 


ken 
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NAME find --— find file with given name 
SYNOPSIS find name or number ... 
DESCRIPTION find searches the entire file system hierarchy 


and gives the path names of all files with the 
specified names or (decimal) i-numbers, 


SEE ALSO = 
DIAGNOSTICS -- 
BUGS -- 


OWNER amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


FOR (I) 


for --— fortran 
for file 


for is a nearly complete fortran compiler. file 
is the name of a fortran source program to be 
compiled, The following is a list of differences 
between for and ANSI standard fortran: 


1. arbitrary combination of types are allowed in 
expressions. Not all combinations are expected 
to be supported in runtime. All of the normal 
conversions involving integer, real and double 
precision are allowed, 


£.tmpi, 2 3 temporary 
/etc/f1, 23 4 passes 
fetc/xx runtime 


Diagnostics are given by number. If the source 
code is available, it is printed with an under- 
iine at the current character pointer, A listing 
of error numbers is available, 


The following is a list of those features not yet 
implemented: 


functions 

arithmetic statement functions 
data statements 

complex constants 

hollerith constants 
continuation cards 


amr, Ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


FORM (T) 
form —- form letter generator 
-form proto AIG, wes 
form generates a form letter from a prototype 
letter, an associative memory, arguments and in a 


special case, the current date, 


If form is invoked with the argument x, the fol- 
lowing files come into play: 


x.f prototype input | 

x.r form letter output 

x.am associative memory 

form.am associative memory if x.am not found. 


Basically, form is a copy process from the file 
x.f to the file x.r. If an element of the form 
\n (where n is a digit from 1 to 9) is encoun- 
tered, The nth argument is inserted in its place, 
and that argument is then rescanned, If \0O is 
encountered, the current date is inserted, If 
the desired argument has not been given, a mes-— 
sage of the form \n: is typed, The response 
typed in then is used for that argument. 


If an element of the form [name] is encountered, 
the name is looked up in the associative memory, 
If it is found, the contents of the memory under 
this name replaces the original element (again 
rescanned,) If the name is not found, a message 
of the form "name: “ is typed. The response 
typed in is used for that element. If the asso- 
ciative memory is writable, the response is en- 
tered in the memory under the name. Thus the 
next search for that name will succeed without 
interaction, 


In both of the above cases, the response is typed 
in by entering arbitrary text terminated by two 
new lines, Only the first of the two new lines 
is passed with the text. The process is instant- 
ly terminated if an end of file is encountered 
anywhere except in the associative memory. 


x.f input file 

x.r output file 

x, am associative memory 
form,am associative memory 
type 


"settup error” when the appropriate files cannot 
be located or created, 


“settup is misspelled. 
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OWNER rhm, ken 


11/3/71 HUP (I) 


NAME hup -- hang up typewriter 

SYNOPSIS hup 

DESCRIPTION hup hangs up the phone on the typewriter which 
uses it, 

FILES -- 

SEE ALSO -— 

DIAGNOSTICS oe 

BUGS should not be used; sometimes causes the type- 


writer channel to be lost, 


OWNER amr, Ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


LBPPT (I) 


lbppt -- load binary paper tapes 

lbppt output [ input ] 

lbppt loads a paper tape in standard UNIX binary 
paper tape format. It is used to bring files to 
a UNIX installation. Currently there is a GECOS 


program to prepare a GECOS file in binary paper 
tape format. 


If the input file is specified, the character 
stream from that input is expected to be in UNIX 
binary paper tape format. If it is not present, 
/dev/ppt is assumed, The input stream is inter- 
preted, checksummed, and copied to the output 
file. 

/dev/ppt 

dbppt, bppt format 

“checksum”; “usage: "3; “read error”. 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


LD (TI) 


ld --— link editor 


ld [ -usaol ] name, J 
id combines several object programs into one; 
resolves external references; and searches li- 
braries, In the simplest case the names of 
several object programs are given, and 1d com-— 
bines them, producing an object module which can 
be either executed or become the input for a 
further ld run. 


The argument routines are concatenated in the 
order specified. The entry point of the output 
is the beginning of the first routine, 


If any argument is a library, it is searched, and 
only those routines defining an unresolved exter- 
nal reference are loaded. If any routine loaded 
from a library refers to an undefined symbol 
which does not become defined by the end of the 
library, the library is searched again. Thus the 
order of libraries primarily affects the effi- 
ciency of loading, not what routines get loaded, 


id understands several flag arguments which are 
written preceded by a - 3: 


-s “squash” the output, that is, remove the 
symbol table and relocation bits to save 
space (but impair the usefulness of the 
debugger). This information can also be 
removed by strip. 


-u take the following argument as a symbol and 
enter it as undefined in the symbol table, 
This is useful for loading wholly from a 
library, since initially the symbol table 
is empty and an unresolved reference is 
needed to force the loading of the first 
routine, 


-o set the origin of the load to the octal 
number which is given as the next argument, 
This option affects only the definition of 
relocatable external symbols. See DMR 
before using. 


~l This option is an abbreviation for a li- 
brary name. "1" alone stands for 
“/etc/liba.a’, which is the standard system 
library for assembly language ~programs, 
-1x”" stands for "/etc/libx.a” where x is 
any character, There are libraries for 
Fortran (x= f") and B (x="b"),. 
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SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


LD (TI) 


~a means “absolute” (load at origin absolute 
0) but it doesn’t work. 


The output of ld is left on a,out, This file is 
executable only if no errors occurred during the 
load, 


f/etc/libx.a, for various x3 
/etc/ltma, ltmb, ... (temporary) 
a,out (output file) - 

as, strip, ar (maintains libraries) 


“can’t create temp file"-- unwritable directory 
or someone else is using ld in the same directo- 


rye 


"can’t open temp file”"-- maybe someone has delet- 
ed it out from under you. 


"file not found”-— bad argument 
“bad format"-- bad argument 


"relocation error”-- bad argument (relocation 
bits corrupted) 


we a we 

bad relocation -- user error: a. relocatable 
reference to an external symbol that turns out to 
be absolute, 


“multiply defined"-— same symbol defined twice in 


‘game load 


“un"-— stands for “undefined symbol” 
"symbol not found"-- loader bug 


Option "-a" doesn’t work at all; option "0" 
doesn’t work right. 


amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


LN (TI) 


ln --— make a link 
in name, [ name. 7} 


in creates a link to an existing file name,. If 
name, is given, the link has that name; otherwise 
it ig placed in the current directory and its 


name is the last component of name, . 


It is forbidden to link to a directory or to link 
across file systems, 


rm, to unlink 


? 


There is nothing particularly wrong with ln, but 
links don’t work right with respect to the backup 
system: one copy is backed up for each link, and 
(more serious) in case of a file system reload 
both copies are restored and the information that 
a link was invoived is iost. 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


Slo lew 


If 


LS (TI) 


-~- list contents of directory 
[ ~ltasda ] name, «4. 


lists the contents of one or more directories 
nder control of several options: 


1 list in long format, giving i-number, mode, 
owner, size in bytes, and time of last 
modification for each file. (see stat for 
format of the mode) 


t sort by time modified (latest first) instead 
of by name, as is normal 


a list all entries; usually those pegouneng 
with . are suppressed 


s give size in blocks for each entry 

ad if argument is a directory, list only its 
name, not its contents (mostly used with 
"-1" to get status on directory) 


no argument is given, ".” is listed, If an 


argument is not a directory, its name is given. 


-fetc/uids to get user ID’s for ls -l 


stat 


w 
n 
un 


In 


ame nonexistent’; "name unreadable”; “name 
statable, 


ls -l1, when a user cannot be found in 


/etc/uids, the user number printed instead of a 
name is incorrect, It is correct in stat. 


dmr, ken 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


MAIL (I) 


mail --— send mail to another user 
mail [ letter person ... ] 


mail without an argument searches for a file 
calied maiibox, prints it if present, and asks if 
it should be saved, If the answer is “y", the 
mail is renamed mail, otherwise it is deleted, 
The answer to the above question may be supplied 
in the letter argument. 


When followed by the names of a letter and one or 
more people, the letter is appended to each 
person’s mailbox. Each letter is RESSERES by the 
sender’s name and a postmark, 


A person is either the name of an entry in the 
directory fusr, in which case the mail is sent to 
/usx/person/mailbox, or the path name of a direc- 
tory, in which case mailbox in that directory is 
used, 


When a user logs in he is informed of the pres-— 
ence of mail. 


/etc/uids to map the sender’s numerical user ID 
to name; mail and mailbox in various directories, 


init 


“who are you?” if the user cannot be identifed, 
for some reason (a bug). Cannot send to user” 
if mailbox cannot be opened, 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


MESG (I) 


mesg -— permit or deny messages 


mesg [n][y] 


mesg n forbids*messages via write by revoking 
non-user write permission on the user’’s typewrit-— 
er, mesg y reinstates permission. mesg with no 
argument reverses the current permission. In all 
cases the previous state is reported. 


/dev/ttyn 


write 


? df the standard input file is not a typewrit- 
er 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


mkdir --— make a directory 
mkdir dirname 


mkdir creates directory dirname, 


The standard entries ".” and ”..” 


tomatically. 


rmdir to remove directories 


? 


MKDIR (I) 


are made au- 


No permissions are checked. The system’s. user 
ID, not that of the creator of the directory, 
becomes the owner of the directory. 


ken, dmr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


MKFS (I) 


mkfs --— make file system 


/etc/mkfs 


/etc/mkfs 


IB het 


mkfs initializes either a DECtape (argument Pes) 
or an RKO3 disk pack (argument r ) so that it 
contains an empty file system. mkfs or its 


equival ent must be used before a tape or wack can 


be mounted as a file system. 


In both cases the super—block, i-list, and free 
list are initialized, and a root. directory con— 
taining entries for . and .. are created. 
For RKO3’s the number of available blocks is 
4872, for tapes 578, 


This program is kept in fete to avoid inadvertant 
use and consequent destruction of information. 


/dev/tapoO, /dev/rkO 


"arg count”, "Unknown argument”, “Open error”. 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


‘BUGS 


OWNER 


MOUNT (TI) 


mount -— mount file system 
mount special dir 


mount announces to the system that a removable 
file system has been mounted on the device 
corresponding to special file special, Directory 
Gir (which must exist already) becomes the name 
of the root of the newly mounted file system. 


umount 


w ww 


? , if the special file is already in use, can- 
not be read, or if dir does not exist. 


Should be usable only by the super-user, 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


MV (I) 


my —-— move or rename a file 


mv name nae eee es 


1 
my changes the name of name, by linking to it 
under the name name, and thén unlinking name, . 
Several pairs of argument s may be given. If the 
new name is a directory, the file is moved to 
that directory under its old name. Directories 
may only be moved within the same parent directo- 
ry (just renamed). 


"?a"—— incorrect argument count 

"?d"-- attempt to move a directory 

ate moving file to itself 

?1 ——- link error; old file doesn’t exist or 
: can’t write new directory 

"2u"-- can’t unlink old name 


Tf mv succeeds in removing the target file, but 

then in unable to link back to the old file, the 
result is 71 and the removal of the target file, 
This is common with demountable file systems and 
should be circumvented, Also in such cases, mv 

should copy if it can, 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


NM (I) 


nm -— get name list 
nm [ name ] 


mm prints the symbol table from the output file 
of an assembler or loader run, Only relocatable, 
global, and undefined symbols— not absolute—- 
are given. Each defined symbol is preceded by 
its value; each undefined symbol by blanks, Glo- 


bal symbols have their first character under- 
lined, The output is ‘sorted alphabetically. 


If no file is given, the symbols in a,out are 
listed. 


a,out 


as, ld 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


OD (I) 


od -— octal dump 
od name [ origin ] 


od dumps a file in octal, eight words per line 
with the origin of the line on the left, If an 
octal origin is given it is truncated to 0 mod 16 
and dumping starts from there, otherwise from 0. 
Printing continues until halted by sending an 


interrupt signal, 


—— 


Dumping does not cease at the end of the file; 
instead the file appears to be padded with gar- 
bage to a length of 511 mod 512 bytes. 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


PR (I) 


pr -- print file 

pr [ -lcm ] name, 2. 

pr produces a printed listing of one or more 
files, The output is separated into pages headed 
by the name of the file, a date, and the page 
number, 

The optional flag -l1 causes each page to contain 
78 lines instead of the standard 66 to accommo- 
date legal size paper, 

The optional flags -c (current date) and —m 
(modified date) specify which date will head all 
subsequent files. -m is default, 

/dev/ttyn to suspend messages. 

cat, cp, mesg 

-— (files not found are ignored) 


none 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


REW (I) 


rew --— rewind tape 
rew [ digit ] 
rew rewinds DECtape drives, The digit is the 


logical tape number, and should range from 0 to 
7. A missing digit indicates drive 0. 


/dev/tapoO, ..., /dev/tap7 


? dif there is no tape mounted on the indicated 
drive or if the file cannot be opened. 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


RKD (I) 


rkd --— dump RK disk to tape 


Letc/rkda 


rkd copies an RKO3/RKOS disk pack onto nine 
DECtapes. 


Physical I/O is done and interrupts are disabled, 
so time-sharing is suspended during operation of 
the command, 


The sequence of tape drives is: 0, 1, 0, 1, .... 


rkd exits if 0 appears in the console switches, 


rkl 


none; errors are retried forever 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


RKF (I) 


rk£f -— format RKO3 disk pack 
rkt 


rkf£ formats a virgin disk pack, Because it des- 
troys all information on that pack, and because 
it is not interlocked against file system activi- 
ty on the pack, the rk£ program is not maintained 
in executable form, Instead the source must be 


located and assembled, 


none (uses physical I/O on drive 0), 


“error” is printed and a core image is produced 
if a write error occurs. A copy of the RK status 
register is in register 5, 


As mentioned, rkf is not interlocked against sys-— 
tem I/O; if I/O is already occurring, it will be 
badly disrupted, In any event, all information 
on the pack is destroyed, 


Ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


RKL (I) 


rkl -- reload RK disk; from tape 

fete/rkl 

rkl loads an RKO5/RKO5 disk pack from nine 
DECtapes, 

The program uses physical I/O with interrupts 
disabled; therefore time-sharing is suspended, 


Only the super-user may invoke this command, 


The sequence of drives is: 0, 1, O, 1, «eee kl 


will cease if O appears in the console switches, 


errors are retried forever 
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NAME 
SYNOPSIS - 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


RM (TI) 


rm -— remove (unlink) files 


rm mene oon 

rm removes the entries for one or more files from 
a directory. If an entry was the last link to 
the file, the file is destroyed, Removal of a 
file requires write permission in its directory, 
but neither read nor write permission on the file 


wee LST TEE 


Directories cannot be removed RY rm; cf. rmdir. 
none 

rmdir, for removing directories, 

If the file cannot be removed or does not exist, 
the name of the file followed by a question mark 
is typed, 


rm probably should ask whether a read-only file 
is really to be removed, 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


RMDIR (I) 


rmdir -— remove directory 
rmdir dir, eee 


rmdir removes (deletes) directories. The direc- 
tory must be empty (except for the standard en- 
tries ".” and ".. , which rmdir itself removes). 
Write permission is required in the directory in 


which the directory appears. 


“dir?” is printed if directory dir cannot be 
found, is not a directory, or is not removable, 


"dir -- directory not empty’ ig printed if dir 
has entries other than . or .e-. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


ROFF (TI) 


roff --— format text 
roff [ +number ] [ -number ] name, ... 


roff formats text according to control lines 
embedded | ,in the text. The optional argument 
"+number” causes printing to begin at the first 
page with the appropriate number; "-number™ 
causes printing to cease at the first pade with 


higher number. 


roff is fully described in a separate publication 


reference], 

/etc/suftab contains a list of suffixes used to 
guide hyphenation, /tmp/rtma, rtmb, ... tem— 
porary. /dev/ttyn to suspend messages, 
[reference], mesg 
none -- files not found are ignored 
roff does not check for various kinds of buffer 
overflow, If a fault occurs, check the input in 
the region where the error occurred. 


jfo, dmr, ken 
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NAME sdate -- set date and time 
SYNOPSIS sdate mmddhhmm 
DESCRIPTION sdate adjusts the system’s idea of the date and 


time. mm is the month number; dd is the day 
number in the month; hh is the hour number 
(24-hour system); mm is the minute number, For 
example, 


sdate 10080045 


sets the date to Oct. 8, 12:45 AM, 


FILES none 

SEE ALSO date 

DIAGNOSTICS "2" if the date is syntactically incorrect, 
BUGS none 


OWNER ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


SH (I) 


sh -- shell (command interpreter) 
sh [ name [ arg, ... [ argg ] J] ] 


sh is the standard command interpreter, It is 
the program which reads and arranges the execu- 
tion of the command lines typed by most users, 

It may itself be called as a command to interpret 
files of command lines, Before discussing the 
arguments to the shell used as a command, the 
structure of command lines themselves will be 
given, 


Command lines are sequences of commands separated 
by command delimiters. Each command is a se- 
quence of non—blank command arguments separated 
by blanks, The first argument specifies the name 
of a command to be executed, Except for certain 
types of special arguments discussed below, the 
arguments other than the command name are simply 
passed to the invoked command. 


If the first argument represents the path name of 
an executable wriie, it is invoked; otherwise the 
string "/bin/" is prepended to the argument. (In 
this way the standard commands, which reside in 
“/pin”, are found,) If this search too fails a 
diagnostic is printed, 


The remaining non-special arguments are simply 
passed to the command without further interpreta- 
tion by the shell. 


There are three command delimiters: , the new 
line, 3 , and & . The semicolon ; specifies 
sequential execution of the commands so 
separated; that is, 


coma; comb 


causes the execution first of command coma, then 
of comb. The ampersand "&". causes simultaneous 
execution: 


coma & comb 


causes coma to be called, followed immediately by 
comb without waiting for coma to finish. Thus 
coma and comb execute simultaneously. As a spe- 
cial case, 


coma & 
causes coma to be executed and the shell immedi- 


ately to Oo request another command without waiting 
for coma. 
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SH (I) 


Two characters cause the immediately following 
string to be interpreted as a special argument to 
the shell itself, not passed to the command, An 
argument of the form <arg causes the file arg | 
to be used as the standard input file of the 
given command; an argument of the form “Sarg” 
causes file arg” to be used as the standard out- 
put file for the given command. 


xe any argument contains either of the characters 
2?” or “* , it is treated specially as follows, 
The current directory is searched for files which 
match the given argument. The character "He" Gn 
an argument matches any string of enereeea = ina 
file name (including the null string); 
matches any single character in a file name. 
Other argument characters match only the same 
character in the file name, For example, mae" 
matches all file names; |? matches all one-—char- 
acter file names; "ab*.s matches all file names 
beginning with "ab" and ending with .s. 


If the argument with "*" or "?” also contains a 

a » a Slightly different procedure is used: 
instead of the current directory, the directory 
used is the one wo ptained by aoeing ge argument 
up to the last "/” before a "*" ? . #=The 
matching process matches the oe eee of the 
argument after this "/" against the files in the 
derived directory, For example: "/usr/dmr/a*, s” 
matches all, files in Sec "/usr/ amr” which 
begin with "a" and end with ° 


In any event, a list of names is obtained which 
match the argument. This list is sorted into 
alphabetical order, and the resulting sequence of 
argument s replaces the single argument containing 
the "*" or "?", The same wprocess is carried out 
for each argument with a "*" or "?" (the result- 
ing lists are not merged) and finally the command 
is called with the resulting list of arguments... 


For example: directory /usr/dmr contains the 
files ai.s, a2.S, ..., a9.S. From any directory, 
the command 


as /usr/dmr/a?.s 


calls as with arguments /usr/dmr/ai.s, 
/usr/dmr/a2.s, ... /usr/dmr/a9.s in that order. 


The character "\" causes the immediately follow- 
ing character to lose any special meaning it may 
have to the shell; in this way "<", ">", and 
other characters meaningful to the shell may be 
passed as part of arguments, A special case of 
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FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


SH (I) 


this feature allows the continuation of commands 
onto more than one line: a new-line preceded by 
"\" 4s translated into a blank. 


Sequences of aanaceese enclosed in double (") or 
single (’) quotes are also taken literally. 


When the shell is invoked as a command, it has 
additional string procéssing capabilities, Re- 
call that the form in which the whell is invoked 
is 


sh [ name [ arg, ... [ argg ] 1] 


The name is the name of a file which will be read 
and interpreted, If not given, this subinstance 
of the shell will continue to read the standard 
input file. 


In the file, character sequences of the form 
"$n", where n is a digit 0, ..., 9, are replaced 
by the nth argument to the’ invocation of the 
shell (arg, Ve "$0" is replaced by name. 


An end-of-file in the shell’s input causes it to 
exit. A side effect of this fact means that the 
way to log out from UNIX is to type an end of 
file, 


/etc/glob 


[reference], which gives the theory of operation 
of the shell, 


"9", in case of any difficulty. The most common 
problem is inability to find the given command, 
Others: input file ( "<") cannot be found; no 
more processes can be created (this will allevi- 
ate itself with the passage of time). Note that 
no diagnostic is given for inability to create an 
output (">") file; the standard output file has 
already been closed when the condition is 
discovered and there is no place to write the 
diagnostic, 

If a "*" or "2" is used, the glob routine is 
invoked; it types No command if it cannot find 
the given command, and "No match” if there | were 
ae files which matched an argument with "2" or 


Better diagnostics should be provided. If a 7 
or "?" is used, the command must be in /bin. 
(Not, for example, in the user’s directory.) This 
is actually a glob bug. 
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OWNER admr, ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


STAT (I) 


stat -- get file status 
stat NAME, se 


stat gives several kinds of information about one 
or more files: 


i—number 

number of links 

owner 

size in bytes 

date and time of last modification 

name (useful when several files are named) 


All information is self-explanatory except the 
mode, The mode is a six-—character string whose 
characters mean the following: 


file is small (smaller than 4096 bytes) 
file is large 


4 


file is a directory 
file is executable 

set user ID on execution 
none of the above 


fh 
icxnxG FN 


3 r: owner can read 
-: owner cannot read 


4 ws: owner can write 
—: owner cannot write 
non-owner can read 


: 
¢ mon-owner cannot read 


: non-owner can write 
$ non-owner cannot write 


The owner is almost always given in symbolic 
form; however if he cannot be found in 

fetc/uids a number is given. 

If the number of arguments to stat is not exactly 
1 a header is generated identifying the fields of 
the status information, 
/etc/uids 


is with the a option gives the same informa- 
tion as stat, 


ow Lid 
name? for any error, 


none 
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OWNER amr 
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FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


STRIP (TI) 


strip -- remove symbols and relocation bits 
strip name, ... 


strip removes the symbol table and relocation 
bits ordinarily attached to ‘the output of the 
assembler and loader, This is useful to save 
Space after a program has been debugged, 


The effect of strip is the same as use of the -s 
option of ld, 


/tmp/stma, stmb ... temporary file 


ld, a 


Diagnostics are given for: non-existent argument; 
inability to create temporary file; 

improper format (not an object file); 

inability to re-read temporary file. 


amr 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


su (TI) 


su. -~ become privileged user 
su password 


su allows one to, become the super—user, who has 
all sorts of marvelous powers. In order for su 
to do its magic, the user must pass as an argu-— 
ment a password, If the password is correct, su 
will execute the shell with the UID set to that 
of the super-user. To restore normal UID 
privileges, type an end-of-file to the super-—user 


shell. 


shell 
“Sorry” if password is wrong 


dmr, Ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


sum —-— sum file 
sum name 


sum sums the contents of a file, 


SUM (I) 


In practice, 


is most often used to verify that all of a 


DECtape can be read without error, 


bawaa 


“o™ af the file cannot be read at all or if an 


error is discovered during the read, 


none 


ken 


it 
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NAME 
SYNOPSIS 


DESCRIPTION 


TAP (I) 


tap -- manipulate DECtape 
tap [key ] [ name... ] 


tap saves and restores selected portions of the 
file system hierarchy on DECtape, Its actions 
are controlled by the key argument. The key is a 
string of characters containing at most one func— 
tion Letter and possibly one or more function 
modifiers, Other arguments to the command are 
file or directory names specifying which files 
are to be dumped, restored, or tabled. 


The function portion of the key is specified by 
one of the following letters: 


r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. If files with the same 
names BET CARY WOKE SE they are replaced 
(hence the. Dg Same is determined by 
string sonpae bach ./abe” can never be 
the same as tiger lane /anen even if 

"/usr/amr” is the current directory. If rm 
file argument is given, "/" is the default. 


-u updates the tape. u is the same as r, but 
a file is replaced only if its modification 
date is later than the date stored on the 
tape; that is to say, if it has changed 
since it was dumped. u is the default com- 
mand if none is given. 


a deletes the named files and directories 
from the tape, At least one file argument 
must be given, 


xX ‘extracts the named files from the tape to 
the file system. The owner, mode, and 
date-modified are restored to what they 
were when the file was dumped. If no file 
argument is given, the entire contents of 
the tape are extracted, 


t lists the names of all files stored on the 
tape which are the same as or are hierarch- 
ically below the file arguments, If no 
file argument is given, the entire contents 
of the tape are tabled. : 


1 is the same as t except that an expanded 
listing is produced giving all the avail- 
able information about the listed files, 


The following characters may be used in addition 
to the letter which selects the function desired. 
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FILES 
SEE ALSO 


DIAGNOSTICS 


TAP (TI) 


O, .«e, 7 This modifier selects the drive on 
which the tape is mounted. O is the 
default. 


vy Normally tap does its work silently. The v 
(verbose) option causes it to type the name 
of each file it treats preceded by a letter 
to*indicate what is happening. 


file is being replaced 

file is being added (not there before) 
file is being extracted 

a file is being deleted 


x OH 


The v option can be used with r, u, gd, and 
x only. 


c means a fresh dump is being created; the 
tape directory will be zeroed before begin- 
ning. Usable only with r and u. 


th 


causes new entries copied on tape to be 
‘fake’ in that only the entries, not the 
data associated with the entries are updat-— 
ed, Such fake entries cannot be extracted, 
Usable only with r and u. 


w causes tap to pause before treating each 
file, type the indicative letter and the 
file name (as with vy) await the user’s 
response, Response y means yes , SO the 
file is treated. Null response means no , 
and the file does not take part in whatever 
is being done, Response x means exit 3; 
the tap command terminates immediately. In 
the x function, files previously asked 
about have been extracted already. With r, 
u, and d no change has been made to the 
tape. 


m make (create) directories during an x if 
necessary. 


i ignore tape errors. It is suggested that 
this option be used with caution to read 
damaged tapes, 


/dev/tapO ... /dev/tap7 
rk 


RK open error 

RK read error 

RK write error 
Directory checksum 
Directory overflow 
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RK overflow 
Phase error (a file has changed after it was 
selected for dumping but before it was dump ed ) 


BUGS All references to “RK” should read “tape,” The m 
option does not work correctly in all cases, The 
i option is not yet implemented, 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


T (I) 


tm -— provide time information 
tm [ command AIG, sees ] 


tm is used to provide timing information, When 
used without an argument, output like the follow— 
ing is given: 


tim 77:43:20 ro, 
Oovh 13:59:42 1. 
ask 12:063;30 4, 
35 
0. 


N 


idl 352:31:37 
usr 33:32:15 
der 5, 171 0, 


N 
OANA NN 


The first column of numbers gives totals in the 
named categories since the last time the system 
was cold—booted; the second column gives the 
changes since the last time tm was invoked, The 
tim row is total real time (hours:minutes: 
seconds); unlike the other times, its origin is 
the creation date of tm’s temporary file. ovh is 
time spent executing in the system; dsk is time 
spent waiting for both kinds of disk I/O; idl is 
idle time; usr is user execution time; der is RF 
disk error count (left number) and RK disk error 
count (right number), 


tm can be invoked with arguments which are as-— 
sumed to constitute a command to be timed. In 
this case the output is as follows: 


tim 2.2 
ovh 0,3 
ask 1.8 
idl 0,0 
usr 0,0 


The given times represent the number of seconds 
spent in each category during execution of the 
command, 


/tmp/ttmp, /dev/rfO (for absolute times) contains 
the information used to calculate the differen- 
tial times, 


format of file system (which tells where the 
times come from) 

"9" af the command cannot be executed; "can ae 
creat temp file if trouble with ttm “cant read 
super-block’ if times cannot be read from system, 


(1) when invoked with a command argument, every- 
thing going on at the moment is counted, not just 
the command itself. (2) Two users doing tm 


11/3/71 T™ (I) 


simultaneously interfere with each other’s use of 
the temporary file, ; 


11/3/71 PTY C14 


NAME tty -- get tty name 
SYNOPSIS tty 
DESCRIPTION tty gives the name of the user’s typewriter in 


the form ttyn for na digit. The actual path 
name is then /dev/ttyn . 


FILES a 

SEE ALSO — 

DIAGNOSTICS "not a tty” if the standard input file is not a 
typewriter. 

BUGS -_— 


OWNER dmr, ken 
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SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


TYPE (I) 


type -- type on 2741 


type TLAMe eve 


type produces output on an IBM 2741 terminal with 
a Correspondence type bail. 


type uses typewriter tty5, which, because of the 
lack of access ports, is also used as a standard 
communication channel. Therefore, who should be 
used to verify the absence of a user on tty5, 


The method is as follows: type the type command, 
It will wait until tty5 is dialled up. When the 
phone answers, depress the interrupt button after 
paper has been loaded, and the first file will be 
typed. type spaces out to the end of a sheet of 
paper and waits until the interrupt button is 
depressed before beginning each new file, 


/dev/tty5 
who 


Obviously some scheme is needed to prevent in- 
terference between normal users and type. The 
best thing would be to support 2741’s as a stan- 
dard terminal. 


dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


UMOUNT (TI) 


umount -— dismount file system 

umount special 

umount announces to the system that the removable 
file system previously mounted on speciai file 


special is to be removed. 


Only the super-—user may issue this command. 


mount 


This command should be restricted to the super- 
user, 


ken, dmr 
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DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


UN (TI) 


un -— undefined symbols 
un [ name ] 


un prints a list of undefined symbols from an 
assembly or loader run. If the file argument is 
not specified, a,out is the default. Names are 
listed alphabetically except that non-global sym- 
hols come first, Undefined global symbols (un- 
resolved external references) have their first 
character underlined, 


a,out 
as, ld 


?” df the file cannot be found. 


dmr, ken 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


we (I) 


we -- get (English) word count 
wc name, eee 


we provides a count of the words, text lines, and 
roff control lines for each argument file, 


A text line is a sequence of characters not be- 
ginning with and ended by a Cece Ar 
control line is a line beginning with . iA 
word is a sequence of characters bounded by the 

beginning of a line, by the end of a line, or by 
a blank or a tab, 


ff 


roff 


none; arguments not found are ignored, 


jfo 
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NAME 
SYNOPSIS 


DESCRIPTION 
FILES 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


WHO (I) 


-- who is on the system 


lists the name, typewriter channel, and login 
time for each current UNIX user, 


/tmp/utmp contains the necessary information; it 
is maintained by init. 


fete/init 
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FILES 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


WRITE (TI) 


write -~ write to another user 
write user 


write copies lines from your typewriter to that 
of another user. When first called, write sends 
the message 


message from yourname,.. 


The recipient of the message should write back at 
this point. Communication continues until an end 
of file is read from the typewriter or an inter- 
rupt is sent. At that point write writes "goT’ 
on the other terminal, 


Permission to write may be denied or granted by 
use of the mesq command, At the outset writing 
is allowed, Certain commands, in particular roff 
and pr, disallow messages in order to prevent 
messy output, 


If the character "1!" is found at the beginning of 
a line, write calls the mini-shell msh to execute 
the rest of the line as a command. 


The following protocol is suggested for using 
write: When you first write to another user, wait 
for him to write back before starting to send, 
Each party should end each message with a dis- 
tinctive signal ("(o)” for over is convention— 
al) that the other may reply. (00)" (for “over 
and out”) is suggested when conversation is about 
to be terminated, 


/tmp/utmp is used to discover the target user’s 
typewriter channel and the sending user’s name, 
msh is used to execute commands. 

mesg 

"user not logged in"; “permission denied”, 


dmr, ken 
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FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS BREAK (ITI) 


break -- set program break 
sys break; addr. / break = 17. 


break sets the system’s idea of the highest loca- 
tion used by the program to addr. Locations 
greater than addr and below the stack pointer are 
not swapped and are thus liable to unexpected 


modification. 
moo LELCat2on. 


If the argument is O or higher than the stack 
pointer the entire 4K word user core area is 
swapped. 


When a program begins execution via exec the 
break is set, at the highest location defined by 
the program and data storage areas. Ordinarily, 
therefore, only programs with growing data areas 
need to use break. 


exec 


none; strange addresses cause the break to be set 
to include all of core. 
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FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


SYS CEMT (II) 


cemt -- catch emt traps 
sys cemt; arg / cemt = 29.3; not in assembler 


This call allows one to catch traps resulting 
from the emt instruction. Arg is a location 
within the program; emt traps are sent to that 
location. The normal effect of emt traps may be 
7 jing an arg equal to O. 
Prior to the use of this call, the result of an 
emt instruction is a simulated rts instruction. 
The operand field is interpreted as a register, 
and an rts instruction is simulated for that 
register (after verifying that various registers 
have appropriate values). This feature is useful 
for debugging, since the most dangerous program 
bugs usually involve an rts with bad data on the 
stack or in a register. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS CHDIR ({P) 


chdir -- change working directory 


sys chdir; dirname / chdir = 12. 


dirname is address of the pathname of a directo- 


ry, terminated by a © byte. chdir causes this 

directory to become the current working directo- 
e 

ry. 


The error bit (c-bit) is set if the given name is 
not that of a directory. 


ken, dmr 
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SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS CHMOD (II) 


chmod -- change mode of file 
sys chmod; name; mode / chmod = 15, 


The file whose name is given as the null- 
terminated string pointed to by name has its mode 
changed to mode. Modes are constructed by oring 
together some combination of the following: 


O01 write, non-owner 

O02 read, non-owner 

04 write, owner 

10 read, owner 

20 executable 

40 set user ID on execution 


Only the owner of a file (or the super-user) may 
change the mode. 


Error bit (c~bit) set if name cannot be found or 
if current user is neither the owner of the file 
nor the super-user. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS CHOWN (II) 


chown -- change owner of file 
sys chown; name; owner / chown = 16, 


The file whose name is given by the null- 
terminated string pointed to by name has its own- 
er changed to owner. Only the present owner of a 
file (or the super-user) may donate the file to 
another user. Also, one may not change the owner 
of a file with the set-user-ID bit on, otherwise 
one could create Trojan Horses able to misuse 
other’s files. 


_—— 


/etc/uids has the mapping between user names and 
user numbers. 


The error bit (c-bit) is set on illegal owner 
changes. 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS CLOSE (II) 


close -- close a file 


(file descriptor in r0O) 
sys close / Close = 6, 


Given a file descriptor such as returned from an 
open or creat call, close closes the associated 
file. A close of all files is automatic on exit, 
ously open files, close is necessary to programs 
which deal with many files. 


creat, open 


The error bit (c-bit) is set for an unknown file 
descriptor. 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS CREAT (ITI) 


creat -- create a new file 


sys creat; name; mode / creat = 8, 
(file descriptor in r0) 


creat creates a new file or prepares to rewrite 
an existing file called name; name is the address 
of a null-terminated string. If the file did not 
exist, it is given mode mode; if it did exist, 
its mode and owner remain unchanged but it is 
truncated to O length. 


The file is also opened for writing, and its file 
descriptor is returned in r0O. 


The mode given is arbitrary; it need not allow 
writing. This feature is used by programs which 
deal with temporary files of fixed names. The 
creation is done with a mode that forbids writ- 
ing. Then if a second instance of the program 
attempts a creat, an error is returned and the 
program knows that the name is unusable for the 
moment. 


If the last link to an open file is removed, the 
file is not destroyed until the file is closed. 


write, close 


The error bit (c-bit) may be set if: a needed 
directory is not readable; the file does not 
exist and the directory in which it is to be 
created is not writable; the file does exist and 
is unwritable; the file is a directory. 


ken, dmr 
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NAME 

SYNOPSIS 
name: 
args: 
argi: 

DESCRIPTION 


SYS EXEC (II) 


exec -- execute a file 
sys exec; name; args / exec = 41% 
<.2e\O> 


argi3; arg2; ...3; 0 
<eue NO> 


exec overlays the calling process with the named 
file, then transfers to the beginning of the core 
image of the file. The first argument to exec is 
a pointer to the name of the file to be executed. 
The second is the address of a list of pointers 
to arguments to be passed to the file. Conven- 
tionally, the first argument is the name of the 
file. Each pointer addresses a string terminated 
by a null byte. 


There can be no return from the file; the calling 
core image is lost. 


The program break is set from the executed file; 
see the format of a.out. 


Once the called file starts execution, the argu- 
ments are passed as follows. The stack pointer 
points to the number of arguments. Just above 
this number is a list of pointers to the argument 
strings. 


sp-> nargs 
arg1 


argn 


argi: <argi\0> 


argn: <argn\0> 


The arguments are placed as high as possible in 
core: just below 60000(8). 


Files remain open across exec calls. However, 
the illegal instruction, emt, quit, and interrupt 
trap specifications are reset to the standard 
values. (See ilgins, cemt, quit, intr.) 


Each user has a real user ID and an effective 
(The real ID identifies the person using the 
system; the effective ID determines his access 
privileges.) exec changes the effective user ID 
to the owner of the executed file if the file has 
the set-user-ID mode. The real user ID is not 
affected, 
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FILES 
SEE ALSO 


DIAGNOSTICS 


fork 


SYS EXEC (II) 


If the file cannot be read or if it is not exe- 
cutable, 
nostic. 


ken, 


amr 


a return from exec constitutes the diag-— 
The error bit (c-bit) is set. 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


SYS EXIT (II) 


exit -- terminate process 
sys exit / exit = 1 

exit is the normal means of terminating a pro- 
cess. All files are closed and the parent pro- 
cess is notified if it is executing a wait. 


navor raturn 
never rerurr 


ken, dmr 
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SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWN ER 


SYS FORK (II) 


fork -~ spawn new process 


sys fork / fork = 2. 
(new process return) 
(old process return) 


fork is the only way new processes are created, 
The new process’s core image is a copy of that of 


tha cal lar oft 


rire +h anil. 
wits Po 7 a an 


> ene onay distinction is the 
return location and the fact that rO in the old 
process contains the process ID of the new pro- 


cess. This process ID is used by wait. 


Fan 
UD 


sys wait, sys exec 
The error bit (c-bit) is set in the old process 
if a new process could not be created because of 
lack of swap space. 


See wait for a subtle bug in process destruction, 


ken, Gmr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS FSTAT (II) 


fstat -- get status of open file 


(file descriptor in r0) 
sys fstat; buf / fstat = 28. 


This call is identical to stat, except that it 
operates on open files instead of files given by 
name. It is most often used to get the status of 
the standard in 
are unknown. 


+ 17 loves 
Ut files, wnoicse names 


sys stat 


The error bit (c-bit) is set if the file descrip- 
tor is unknown. 


ken, Gmr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


SYS GETUID (II) 


getuid -- get user identification 


sys getuid / getuid = 24. 
f 


{user ID in r0)} 

getuid returns the real user ID of the current 
process. The real user ID identifies the person 
who is logged in, in contradistinction to the 


effective user ID, which determines his access 
permission at each moment. It is thus useful to 
programs which operate using the set user ID 


mode, to find out who invoked them. 


/etc/uids can be used to map the user ID number 
into a name. 


setuid 


ken, Gmr 
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NAME 


SYNOPSIS 


arg: 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS GTTY (II) 


gtty -- get typewriter status 


(file descriptor in r0O) 


sys gtty; arg / gtty = 32.3; not in assembler 
ees 
o=.+6 


gtty stores in the three words addressed by arg 
the status of the typewriter whose file descrip-— 
tor is given in r0. The format is the same as 
that passed by stty. 


stty 


Error bit (c-bit) is set if the file descriptor 
does not refer to a typewriter. 
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FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


SYS ILGINS (II) 


ilgins -- catch illegal instruction trap 
sys ilgins; arg / ilgins = 33.3; not in assembler 


ilgins allows a program to catch illegal instruc- 
tion traps. If arg is zero, the normal instruc- 
tion trap handling is done: the process is ter- 
minated and a core image is produced. If arg is 
a location within the program, control is passed 
to arg when the trap occurs. 

This call is used to implement the floating point 
simulator, which catches and interprets 11/45 
floating point instructions. 


fptrap, the floating point package 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


SYS INTR (II) 


intr -- set interrupt handling 
sys intr; arg / intr = 27. 


When arg is 0, interrupts (ASCII DELETE) are 
ignored. When arg is 1, interrupts cause their 
normal result, that is, force an exit. When arg 
isa location within the ee control is 


1 is i 
Cransterred tc that. Lsocatic hen an interrupt 
occurs. 


After an interrupt is caught, it is possible to 
resume execution by means of an rti instruction; 
however, great care must be exercised, Since all 
I/O is terminated abruptly upon an interrupt. In 
particular, reads of the typewriter tend to re- 
turn with 0 characters read, thus simulating an 
end of file. 


It should be easier to resume after an interrupt, 
but I don’t know how to make it work. 


ken, dmr 
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DESCRIPTION 


PILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS LINK (|) 


link -- link to a file 
sys link; name,; name, / link = 9. 


A link to name, is created; the link has name 
name,. Either name may be an arbitrary path 
name‘ 


unlink 


The error bit (c-bit) is set when name, cannot be 
found; when name. already exists; when the direc- 
tory of name, cannot be written; when an attempt 
is made to link to a directory by a user other 
than the super-user. 


ken, dmr 
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SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS MKDIR (II) 


mkdir -- make a directory 
sys mkdir; name; mode / mkdir = 14. 


mkdir creates an empty directory whose name is 
the null-terminated string pointed to by name. 
The mode of the directory is mode. The special 
entries . and .. are not present, 


mkdir can only be invoked by the super-—-user. 
mkdir command 


Error bit (c-bit) is set if the directory already 
exists or if the user is not the super-user. 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


OWNER 


SYS MOUNT (II) 


mount -- mount file system 


SyS mount; special; name / mount = 21.3 not in 
mount announces to the system that a removable 
file system has been mounted on special file 
special; from now on, references to file name 
will refer to the root file on the newly mounted 


file syvstam Snaeartal and na 
fisac system. 


ar sinters ts 
epeciags ANG NaMe are pointers cto 


null-terminated strings containing the appropri- 
ate path names, 


Name must exist already. If it had useful con- 
tents, they are inaccessible while the file sys- 
tem is mounted, 


Almost always, name should be a directory so that 
an entire file system, not just one file, may 
exist on the removable device. 


umount 


Error bit (c-bit) set if special is inaccessible 
or dir does not exist. 


At most one removable device can be mounted ata 
time. The use of this call should be restricted 
to the super-user,. 


ken, dmr 


assembler 


14/3/71 


NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS OPEN (ITI) 


open -- open for reading or writing 


sys open; name; mode / open = 5. 
(descriptor in rO) 


open opens the file name for reading (if mode is 
0) or writing (if mode is non-zero), name is the 
address of a string of ASCII characters 
representing a path name, terminated by a nuli 
character, 


The file descriptor should be saved for subse- 
quent calls to read (or write) and close. 


In both the read and write case the file pointer 
is set to the beginning of the file. 


If the last link to an open file is removed, the 
file is not destroyed until it is closed. 


creat, read, write, close 
The error bit (c-bit) is set if the file does not 
exist, if one of the necessary directories does 


not exist or is unreadable, or if the file is not 
readable, 


ken, dmr 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


SYS QUIT (II) 


quit -- turn off quit signal 
sys quit; flag / quit = 26, 


When flag is 0, this call disables quit signals 
from the typewriter (ASCII FS). When flag is 1, 
quits are re-enabled, and cause execution to 
cease and a core image to be produced. When flag 
is an address in the program, a quit causes con- 


trol to be sent to that address, 


Quits should be turned off only with due con- 
sideration. 


= \ 


sys intr turns off interrupts 


11/3/71 
NAME 


SYNOPSIS 


DESCRIPTION 


FILES 


SEE ALSO 


DTAGNOSTICS 


BUGS 


OWNER 


SYS READ (II) 


read -- read from file 


(file descriptor in r0) 
sys read; buffer; nchars / read = 3. 
(nread in rO) 


A file descriptor is a word returned from a suc- 
cessful open call. 


Buffer is the location of nchars contiguous bytes 
into which the input will be placed. It is not 
guaranteed that all nchars bytes will be read, 
however; for example if the file refers toa 
typewriter at most one line will be returned, In 
any event the number of characters read is re- 
turned in rO, 


If rO returns with value 0, then end-of-file has 
been reached. 


open 


As mentioned, rO is 0 on return when the end of 
the file has been reached. If the read was 
otherwise unsuccessful the error bit (c-bit) is 
set. Many conditions, all rare, can generate an 
error: physical I/O errors, bad buffer address, 
preposterous nchars, file descriptor not that of 
an input file. 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


SYS RELE (II) 


rele -- release processor 
sys rele / rele = 0; not in assembler 


This call causes the process to be swapped out 
immediately if another process wants to run, Its 
main reason for being is internal to the system, 
namely to implement timer-runout swaps. However, 
it can be used beneficially by programs which 
wish to loop for some reason without consuming 
more processor time than necessary. 


ken, Gmr 


11/3/71 


NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS SEEK (ITI) 


seek -- move read/write pointer 
(file descriptor in rO) 

eek 3 0 3; ptrname / seek = 19. 
The file descriptor refers to a file open for 
reading or writing. The read (or write) pointer 
for the file is set as follows: 


if ptrname is 0, the pointer is set to offset. 


if ptrname is 1, the pointer is set to its 
current location plus offset. 


if ptrname is 2, the pointer is set to the 
size of the file plus offset. 


tell 


The error bit (c-bit) is set for an undefined 
file descriptor. 


A file can conceptually be as large as 2**20 
bytes. Clearly only 2**16 bytes can be addressed 
by seek. The problem is most acute on the tape 
files and RK and RF. Something is going to be 
done about this. 


ken, dmr 


11/3/71 


NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS SETUID (ITI) 


setuid -~-- set process ID 


(process ID in r0O) 


- mated 


+r al ee oe oe 
yo SeeusLu f Seeus — 


The user ID of the current process is set to the 
argument in rO. Both the effective and the real 
user ID are set. This call is only permitted to 


the sumer—ucar 
ene Super-user. 


getuid 


Error bit (c-bit) is set if the current user ID 
is not that of the super-user, 
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11/3/71 


NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS SMDATE (IT) 


smdate -- set modified date on file 


(time to AC-MQ) 


meen mantae F4 
a 


File is the address of a nuli-terminated string 
giving the name of a file. The modified time of 
the file is set to the time given in the AC~MQ 


racisters. 
registers. 
This call is allowed only to the super-user. 


Error bit is set if the user is not the super- 
user or if the file cannot be found. 


ken, dmr 


11/3/71 SYS STAT (II) 


NAME stat -- get file status 
SYNOPSIS sys stat; name; buf / stat = 18. 
DESCRIPTION name points to a null-terminated string naming a 


file; buf is the address of a 34(10) byte buffer 
into which information is placed concerning the 
file. It is unnecessary to have any permissions 
at all with respect to the file, but all direc- 


ae Gas eld 2UEG VOL Fwy & 


tories leading to the file must be readable. 


After stat, buf has the following format: 


buf, +1 i-number — 

+2,+3 flags (see below) 

+4 number of links 

+5 user ID of owner 

+6,+7 size in bytes 

+8,+9 first indirect block or contents block 
+22,+23 eighth indirect block or contents block 


+24,+25,+26,+27 creation time 
+28,+29,+30,+31 modification time 
+32,+33 unused 


The flags are as follows: 


100000 used (always on) 

040000 directory 

020000 file has been modified (always on) 
010000 large file 

000040 set user ID 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000004 write, non-owner 


FILES -- 

SEE ALSO fstat 

DIAGNOSTICS Error bit (c-bit) is set if the file cannot be 
found. 

BUGS The format is going to change someday. 


OWNER ken, amr 


11/3/71 


NAME 


SYNOPSIS 


DESCRIPTION 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS STIME (II) 


stime -- set time 


(time in AC-MQ) 
f 


sys stime / stime = 25.; 


stime sets the system’s idea of the time and 
date. Only the super-user may use this call. 


sys time 


Error bit (c-bit) set if user is not the super- 
user, 


11/3/71 


NAME 


SYNOPSIS 


arg: 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS sTTY (ITI) 


stty -- set mode of typewriter 


(file descriptor in r0) 
sys stty; arg / stty = 3 


dersr; dcpsr; mode 


Stty sets mode bits for a typewriter whose file 
descriptor is passed in rQ. First, the system 
delays until the typewriter is quiescent. Then, 
the argument decrsr is placed into the typewri- 
ter’s reader control and status register, and 
dcpsr is placed in the printer control and status 
register. The DC-11 manual must be consulted for 
the format of these words. For the purpose of 
this call, the most important role of these argu- 
ments is to adjust to the speed of the typewrit-— 
er. 


The mode arguments contains several bits which 
determine the system’s treatment of the 
typewriter: 


200 even (M37 tty) parity allowed 

100 odd (non-M37 tty) allowed 

040 raw mode: wake up on all characters 

020 map CR into LF; echo LF or CR as CR~LF 

010 don’t echo (half duplex) 

004 map upper case to lower case on input (M33 


Characters with the wrong parity, as determined 
by bits 200 and 100, are ignored. 


In raw mode, every character is passed back im- 
mediately to the program. No erase or kill pro- 
cessing is done; the end-of-file character (EOT), 
the interrupt character (DELETE) and the quit 
character (FS) are not treated specially. 


Mode 020 causes input carriage returns to be 
turned into new-lines; input of either CR or LF 


causes CR-LF both to be echoed (used for GE Ter- 
miNet 300’s). 


gtty 


The error bit (c-bit) is set if the file descrip- 
tor does not refer to a typewriter. 


This call should be used with care. It is all 
too easy to turn off your typewriter. 


ken, dmr 


TTY) 


11/3/71 
NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO. 


DIAGNOSTICS 


BUGS 


OWNER 


SYS TELL (IT) 


tell -- get file pointer 
(file descriptor in r0) 
sys teil; offset; ptrname / tell = 20. 


(value returned in rQ) 


The file descriptor refers to an open file. The 
value returned in rO is one of: 


if ptrname is 0, the value returned is offset; 


if ptrname is 1, the value is the current 
pointer plus offset; 


if ptrname is 2, the value returned is the 
number of bytes in the file plus offset. 


seek 


The error bit (c-bit) is set if the file descrip-— 
tor is unknown. 


Tell doesn’t work. Complain if you need it. 


ken, dmr 


11/3/71 


NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


SYS TIME ( {f) 


time -- get time of year 
sys time / time = 13, 
(time AC-MQ) 


time returns the time since 00:00:00, Jan. 1, 
1971, measured in sixtieths of a second. The 
high order word is in the AC register and the low 


Or OS te ee eo en oO ee | 


The chronological~minded user will note that 
2**32 sixtieths of a second is only about 2.5 
years, 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS UMOUNT (II) 


umount -- dismount file system 


sys umount; special / umount = 22.3 not in assembler 


umount announces to the system that special file 


Special is no longer to contain a removable file 
system. The file associated with the special 
file reverts to its ordinary interpretation (see 


mont ) 
mount}. 


The user must take care that all activity on the 
file system has ceased. 


mount 


Error bit (c-bit) set if no file system was 
mounted on the special file. 


Use of this call should be restricted to the 
super—user. 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS UNLINK (ITI) 


unlink -- remove directory entry 
sys unlink; name / unlink = 10. 


Name points to a null-terminated string. Unlink 
removes the entry for the file pointed to by name 
from its directory. If this entry was the last 
link to the file, the contents of the file are 


Ffrantn anA tha Fila 
tis 


Aaaetroavad TE hawauvar 
At GU aban we lI tw a 


is NA ee Zz aig WW Vt 
the file was open in any process, the actual des- 
truction is delayed until it is closed, even 
though the directory entry has disappeared. 


link 


The error bit (c-bit) is set to indicate that the 
file does not exist or that its directory cannot 

be written. Write permission is not required on 

the file itself. It is also illegal to unlink a 

directory (except for the super-user). 


Probably write permission should be required to 
remove the last link to a file, but this gets in 
other problems (namely, one can donate an un- 
deletable file to someone else). 


If the system crashes while a file is waiting to 
be deleted because it is open, the space is lost. 


ken, dmr 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS WAIT (II) 


wait -- wait for process to die 


sys wait / wait = 7. 
(process ID in r0O) 


wait causes its caller to delay until one of its 
child processes terminates. If any child has 
already died, return is immediate; if there are 
no Children, return is immediate with the error 
bit set. In the case of several children several 
waits are needed to learn of all the deaths. 


fork 


error bit (c-bit) on if no children not previous- 
ly waited for. 


A child which dies but is never waited for is not 
really gone in that it still consumes disk swap 
and system table space. This can make it impos- 
sible to create new processes, The bug can be 
noticed when several & separators are given to 
the shell not followed by an command without an 
ampersand. Ordinarily things clean themselves up 
when an ordinary command is typed, but it is pos- 
sible to get into a situation in which no com- 
mands are accepted, so no waits are done; the 
system is then hung. 


The fix, probably, is to have a new kind of fork 
Which creates a process for which no wait is 
necessary (or possible); also to limit the number 
of active or inactive descendants allowed toa 
process, 


ken, amr 


11/3/7% 
NAME 


SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


SYS WRITE (1?) 


write -- write.on file 


(file descriptor in r0O) 


sys write; buffer; nch 


(number written in r0O) 


A file descriptor is a word returned from a suc-— 
cessful open or creat call. 


buffer is the address of nchars contiguous bytes 


which are written on the output file. The number 
of characters actually written is returned in r0Q, 
It should be regarded as an error if this is not 
the same as requested. 


For disk and tape files, writes which are multi- 
ples of 512 characters long and begin ona 
512-byte boundary are more efficient than any 
others. 


sys creat, Sys open 
The error bit (c-bit) is set on an error: bad 


descriptor, buffer address, or count. physical 
I/O errors; 


ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


ATOF (III) 


atof -- ascii to floating 
jsxr r5,atof; subr 


atof will convert an ascii stream to a floating 
number returned in frO. The subroutine subr is 
called on r5 for each character of the ascii 
stream, subr should return the character in rO. 
The first character not used in the conversion is 
left in r0. The floating point simulation should 
be active in either floating or double mode, but 
in single precision integer mode. 


kept in /etc/liba.a 
fptrap 


The subroutine subr should not disturb any regis-— 
ters, 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


ATOI (IIT) 


atoi -- ascii to integer 
jsr r5,atoi; subr 


atoi will convert an ascii stream to a binary 

number returned in mq. The subroutine subr is 
called on r5 for each character of the ascii 
stream. subr should return the character in ro. 


te eee ee ae en ee ee ee 


mi. + _s —_ iL = - «ee ew te than tan 
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left in r0O. 


kept in /etc/liba.a 


The subroutine subr should not disturb any regis- 
ters. 


ken 


1/3774 
NAME 


. SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


mW BP 


CTIME (III) 


ctime -- convert date and time to ASCII 


(move time to AC-MC) 
mov Sbuffer, r0 
jsr pe, ctime 


The buffer is 15 characters long, The time has 
the format 


Oct 9 17:32:24 


The input time is in the AC and MQ registers in 
the form returned by sys time. 


kept in /etc/liba.a 
ptime, to print time; sys time 


The time is not taken modulo 1 year. (Jan 14 
comes out Dec 32.) Also, the clock period is only 


a ceurle of years. 


amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


EXP (III) 


exp -- exponential function 

jsr r5,exp 

The exponential of frO is returned in frO. The 
floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode, 

kept in /etc/liba.a 

fptrap 


Large arguments will cause an overflow fault from 
the floating point simulator, 


ken 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


DIAGNOSTICS 


BUGS 


OWNER 


FPTRAP (III) 


fptrap -- floating point simulator 

sys 33.3; fptrap 

fptrap is a program designed to pick up illegal 
instruction in order to simuiate a sub-set of the 
141/45 floating point hardware, 

kept in /etc/liba.a 


as, PDP-11/45 manual 


’ 
none, hardware gives no diagnostics, 

The simulation, if unsuccessful for any reason 
gives an IOT fault from inside the simulator, 
This should be handeled better, 


ken, amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


FTOA (III) 


ftoa -- floating to ascii conversion 
jsx r5,ftoa; subr 


ftoa will convert the floating point number in 
frO into ascii in the form (-]d.dddddddde|[-Jjdd*, 
The floating point simulator should be active in 
either floating or double mode, but in single 


integer mode, For each character generated by 


ease ey ates SeeSl OL! A 


ftoa, the subroutine subr is called on register 
r5 with the character in ro. 


kept in /etc/liba.a 
fptrap 


The subroutine subr should not disturb any regis- 
ters. 


ken 


VAG Sh 74 GETW, GETC, FOPEN (III) 


NAME getw, getc, fopen -- buffered input 
SYNOPSIS mov $filename, ro 
isr r5,fopen; iobuf 


sx r5,getc; 

character in r0Q) 
jsr r5,getw; iobuf 
(word in rO) 


DESCRIPTION These routines are used to provide a buffered 
input facility. jiobuf is the address of a 
134(10) byte buffer area whose contents are main- 
tained by these routines. Its format is: 


ieptrs <ayt2 / file descriptor 
caer? / characters left in buffer 
s=erZ / ptr to next character 
e=et128. / the buffer 


fopen should be called initially to open the 
file. On return, the error bit (c-bit) is set if 
the cpen failed, Tf fopen is never caller, cer 
will read from the standard input file. 


getc returns the next byte from the file in ro. 
The error bit is set on end of file or a read 
error. 


getw returns the next word in r0. getc and getw 
may be used alternately; there are no odd/even 
problems. 


iobuf must be provided by the user; it must be on 
a word boundary. 


FILES kept in /etc/liba,a 

SEE ALSO sys open, sys read; putc, putw, fcreat 
DIAGNOSTICS c-bit set on EOF or error 

BUGS for greater speed, the buffer should be 512 bytes 


long. Unfortunately, this will cause several 
existing programs to stop working. 


OWNER. ~ amr 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWN ER 


ITOA (IIT) 


itoa -- integer to ascii conversion 
jsr r5,itoa; subr 


itoa will convert the number in rO into ascii 
decimal possibly preceded by a - sign. For each 
character generated by itoa, the subroutine subr 
is called on register r5 with the character in 


ro. 
kept in /etc/liba.a 


The subroutine subr should not disturb any regis-— 
ters. 


ken 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


‘BUGS 


OWN ER 


“LOG (III) 


log -- logarithm base e 
jsr r5,log 


The logarithm base e of frO is returned in fro. 


me. £7 ort ra - 1 1 + + + 
The floating point simulation should be active in 


either floating or double mode, but in single 
precision integer mode, 

kept in -/etc/liba,a 

fptrap 


The error bit (c-bit) is set if the input argu- 
ment is less than or equal to zero. 


ken 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


Co ed 


SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


MESG (III) 


mesg -~ write message on typewriter 

jsr r5,mesg; <Now is the time\0>; .even 
mesq writes the string immediately following its 
call onto the standard output fiie. The string 


is terminated by a 0 byte. 


fetc/liba.a, standard output file 


41/3/71 


NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN IK 


PTIME (III) 


ptime -- print date and time 


(move time to ac-mq) 


mov £iie,z0 
jsr pc, ptime 


ptime prints the date and time in the form 


Oct 9 17:20:33 


- 


on the file whose file descriptor is in rO. The 
string is 15 characters long. The time to be 
printed is placed in the AC and MQ registers in 
the form returned by sys time. 

kept in /etc/liba.a 


sys time, ctime (used to de the conversion) 


see ctime 


amr, Ken 
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NAME 


SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


PUTC, PUTW, FCREAT, FLUSH (III) 


putc, putw, fcreat, flush -- buffered output 
mov Sfilename,ro 
jer v5,fcreat; iobuf 


(get byte in rO) 


jsr r5,putc; iobuf 
(get word in r0) 

jsr r5,putw; iobuf 
jsr r5,flush; iobuf 


fcreat creates the given file (mode 17) and sets 
up the buffer iobuf (size 134(10) bytes); pute 
and putw write a byte or word respectively onto 
the file; flush forces the contents of the buffer 
to be written, but does not close the file. The 
format of the buffer is: 


hate ee a. La es SNA de 


iobufs .«=.4+2 / file descriptor 
eur? / characters unused in buffer 
<SyFtzZ / ptr to next free character 
=e ti1Z5, / butter 


fcreat sets the error bit (c-—bit) if the file 
creation failed; none of the other routines re- 
turn error information, : 


Before terminating, a program should call flush 
to force out the last of the output. 


The user must supply iobuf, which shculd begin on 
a word boundary. 


kept in./etc/liba.va 

sys creat; sys write; getc, getw, fopen 
error bit possible on fereat call 
buffers should be changed to 512 bytes. 


amr 


11/3/71 SIN, COS (TIT) 


NAME sin, cos --— sine cosine 
SYNOPSIS jsr r5,sin (cos) 
DESCRIPTION The sine (cosine) of frO (radians) is returned in 


fro. The floating point simulation should be 
active in either floating or double mode, but in 
sincle precision integer mode. All floating 
reaqisters are used, 


FILES kept in /etc/liba.a 
SEE ALSO fptrap 
DIAGNOSTICS -- 


BUGS Size of the argument should be checked to make 
sure the result is meaningful, 


OWNER ken, Qmr 
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NAME 


SYNOPSIS 


swtab: 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWN ER 


SWITCH (III) 


switch -- switch on value 


(switch value in rO 


F ' 
sx xrS,switch; swtab 


(not-found return) 


vali; labi; 


valn: labn 


fh g ewes 


eet 9° 


switch compares the value of rO against each of 


the val.; if a match is found, control is 
transferred to the corresponding lab, (after pop- 
ping the stack once). If no match has been found 
by the time a null lab; occurs, switch returns. 


kept in /etc/liba.a 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


/DEV/MEM (IV) 


mem —-- Core memory 


mem maps the core memory of the computer into a 
file. It may be used, for example, to examine, 
and even to patch the system using the debugger. 


Mem is a byte-oriented file: its bytes are num- 


bered 0 to 65,535. 


If a location not corresponding to implemented 
memory is read or written, the system will incur 
a bus-error trap and, in panic, will reboot it- 
self. 


ken, amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


/DEV/PPT (IV) 


ppt -- punched paper tape 


ppt refers to the paper tape reader or punch, 
depending on whether it is read or written. 


When ppt is opened for writing, a 100-character 

leader is punched. Thereafter each byte written 
is punched on the tape. No editing of the char- 
acters is performed. When the file is closed, a 
100-character trailer is punched. 


When ppt is opened for reading, the process waits 
until tape is placed in the reader and the reader 
is on-line. Then requests to read cause the 
characters read to be passed back to the program, 
again without any editing. This means that 
several null characters will usually appear at 
the beginning of the file; they correspond to the 
tape leader. Likewise several nulls are likely 
to appear at the end. End-of-file is generated 
when the tape runs out. 


Seek calls for this file are meaningless and are 
effectively ignored (nowever, the read/write 
pointers are maintained and an arbitrary sequence 
of reads or writes intermixed with seeks will 
give apparently correct results when checked with 
tell). 


lbppt, dbppt, bppt format 


Previously, there were separate special files for 
ASCII tape (which caused null characters to be 
suppressed) and binary tape (which used a blocked 
format with checksums). These notions were con- 
ceptually quite attractive, but they were dis- 
carded to save space in the system. 
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/DEV/RFO (IV) 


rfO -- RF11-RS11 fixed-head disk file 


This file refers to the entire RF disk. It may 
be either read or written, although writing is 

inherently very dangerous, since a file system 

resides there. 


The disk contains 1024 256-word blocks, numbered 
O to 1023. Like the other block-structured dev- 
ices (tape, RK disk) this file is addressed in 
blocks, not bytes, This has two consequences: 


‘seek Calls refer to block numbers, not byte 


numbers; and sequential reading or writing always 
advance the read or write pointer by at least one 
block. Thus successive reads of 10 characters 
from this file actually read the first 10 charac— 
ters from successive blocks. 


/dev/tap0O, /dev/rkO 


The fact that this device is addressed in terms 
of blocks, not bytes, is extremely unfortunate. 
It is due entirely to the fact that read and 
write pointers (and consequently the arguments to 
seek and tell) are single-precision numbers, 

This really has to be changed but unfortunately 
the repercussions are serious. 


ken, dmr 
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rkO -~- RKO3 (or RKOS) disk 


rkQ refers to the entire RKO3 disk as a single 
sequentially-addressed file. Its 256-word blocks 
are numbered 0 to 4871. Like the RF disk and the 
tape files, its addressing is block~-oriented. 
Consult the /dev/rfO section. 


/dev/rfo, /dev/tapo 


—— 


See /dev/rf0o 


ken, dmr 
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/DEV/TAPO ... TAP7 (IV) 


tapO ... tap7 


These files refer to DECtape drives 0 to 7. 

Since the logical drive number can be manually 
set, all eight files exist even though at present 
there are only two physical drives. 


The 256-word blocks on a standard DECtape are 
numbered 0 to 577. However, the system makes no 
assumption about this number; a block can be read 
or written if it exists on the tape and not oth- 
erwise. An error is returned if a transaction is 
attempted for a block which does not exist. 


Like the RK and RF special files, addressing on 
the tape files is block-oriented. See the RFO 


esate 


section. 
/dev/rf0, /dev/rko 
see /dev/rf0O 
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/DEV/TTY (IV) 


tty -- console typewriter 


tty (as distinct from tty0, ..., tty5) refers to 

the console typewriter hard-wired to the PDP-ii. 

Most of the time it is turned off and so has lit- 
tle general use, 


Generally, the disciplines involved in dealing 
with tty are similar to those for ttyO ... and 
the appropriate section should be consulted. The 
following differences are salient: 


The system calls stty and gtty do not apply to 
this device. It cannot be placed in raw mode; on 
input, upper case letters are always mapped into 
lower case letters; a carriage return is echoed 
when a line-feed is typed. 


The quit character is not FS (as with tty0...) 
but is generated by the key labelled alt mode. 


By appropriate console switch settings, it is 
possible to cause UNIX to come up as a single- 
user system with I/O on this device. 


/dev/ttyO...3 init 
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/DEV/TTYO ... TTYS (IV) 


ttyO ... tty -- communications interfaces 


These files refer to DCi1 asynchronous communica- 
tions interfaces. At the moment there are six of 
them, but the number is subject to change. Names 
for up to four others will be constructed by an 
obvious algorithm. 


. When one of these files is opened, it causes the 


process to wait until a connection is esta- 
blished. (In practice, however, user’s programs. 
seldom open these files; they are opened by init 
and become a user’s standard input and output 
file.) The very first typewriter file open ina 
process becomes the control typewriter for that 
process. The control typewriter plays a special 
role in the handling quit or interrupt signals, 
as discussed below. The control typewriter is 
inherited by a child process during a fork. 


A terminal associated with one of these files 
ordinarily operates in full-duplex mode. Charac- 
ters may be typed at any time, even while output 
1s occurring, ana are oniy lost when the system s 
character input buffers become completely choked, 
which is very rare. 


When first opened, the interface expects the ter- 
minal to use 15 odd-parity, 10-bit ASCII charac- 
ters per second and to have the new-line func- 
tion. Finally, the system calculates delays 
after sending the code for certain functions 
(e.g., new-line, tab) on the assumption that the 
terminal is a Teletype model 37. All this is 
merely a long way of saying that the system ex- 
pects to be used by a TTY 37. However, most of 
these assumptions can be changed by a special 
system calls: in particular, the expected parity 
can be Changed; the speed, character size, and 
stop bits can be changed (speeds available are 
134.5, 150, 300, 1200 baud; see the DC1i1 manual) ; 
the new-line function can be simulated by a com- 
bination of the carriage-return and line-feed 
functions; Carriage return can be translated into 
new-line on input; upper case letters can be 
mapped into lower case letters; echoing can be 
turned off so the terminal operates in half du- 
plex. See the system call stty. (Also see init 
for the way 300-baud terminals are detected.) 


Normally, a typewriter operates in units of 
lines. This means that a program attempting to 
read will be suspended until an entire line has 
been typed. Also, no matter how many characters 
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/DEV/TTYO ... TTY5S (IV) 


are requested in the read call, at most one line 
will be returned. It is not however necessary to 
read a whole line at ZOneSs any number of charac- 
ters may be requested in a read, even one, 


without losing information. 


The EOT character may be used to generate an end 
of file from a typewriter. When an EOT is re- 
ceived, all the characters waiting to be read are 
immediately passed to the program, without wait- 
ing for a new-line. Thus if there are no charac- 
ters waiting, which is to say the EOT occurred at 
the beginning of a line, zero characters will be 
passed back, and this is the standard end-of-file 
signal. 


When the carrier signal from the dataset drops 
(usually because the user has hung up his termi- 
nal) any read returns with an end-of-file indica- 
tion. Thus programs which read a typewriter and 
are sensitive to end-of-file on their inputs 
(which all programs whould be) will terminate 
appropriately when hung up on. 


Two characters have a special meaning when typed. 
The, ASCII DEL character (sometimes caileda "rub- 
out’) is the interrupt signal. When this charac- 
ter is received from a given typewriter, a search 
is made for all processes which have this type- 
writer as their control typewriter, and which 
have not informed the system that they wish to 
ignore interrupts. If there is more than one 
such process, one of these is selected, for prac- 
tical purposes at random. Then either the pro- 
cess is forced to exit or a trap is simulated to 
an agreed-upon location in the process. See sys 
intr for more information. 


The ASCII character FS is the guit signal. Its 
treatment is identical to the interrupt signal 
except that unless the receiving process has made 
other arrangements it will not only be terminated 
but a core image file will be written. (See sys 
quit for more information.) 


During input, erase and kill processing is nor- 
mally done. The character "#” erases the last 
character typed, except that it will not erase 
beyond the beginning of a line or an EOF. The 
character "@” kills the entire line up to the 
point where it was typed, but not beyond an EOF. 
Both these characters operate on a keystroke 
basis independently of any backspacing or tabbing 
that may have been done, Either @ or "#" may 
be entered literally by preceding it by ya the 
erase or kill character remains, but the 
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/DEV/ TINO: da TELS: CIV) 


-d@isappears. 


It is also possible (again by sys stty) to put 
the typewriter into raw mode. In this mode, the 
program reading is wakened on each character, and 
when a program reads, it waits only until at 
least one character has been typed. In raw mode, 
no erase or kill processiny is done; and the EOT, 
quit and interrupt characters are not treated 
specially. 


Output is prosaic compared to input. It should 
be noted, however, that when one or more charac- 
ters are written, they are actually transmitted 
to the terminal as soon as previously-written 
characters have finished typing. When a program 
produces characters too rapidly to be typed, as 
is very common, it may be suspended for a time. 


Odd parity is always generated on output, except 
that the characters EOT and NAK have the wrong 
parity. Thus the 37 TTY will not hang up (EOT) 
or lock its keyboard (NAK) if a program acciden- 


a | 


tally prints these characters. 


As has been suggested, UNIX has a heavy predispo- 
sition towards 37 Teletype terminals. However, 
it is quite possible to use 300-baud terminals 
such as the GE TermiNet 300. (See init for the 
procedure.) The main difficulty in practice is 
37-oriented delay calculations. 


Terminals such as the IBM 2741 would theoretical- 
ly be very desirable but there are many difficul- 
ties related to its inadequate and non-ASCII 
character sets (the 2741 has two, count ’em) and 
the inherently half-duplex nature of the termi- 
nal. It is possible to produce output on a 2741; 
cf type. 


ken, dmr 
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A,oUuT (V) 


a,out -- assembler and link editor output 


a,out is the output file of the assembler as and 
the link editor id. In both cases, aout is exe- 
cutable provided there were no errors and no 
unresolved external references, 


This file has four sections: a header, the pro- 
gram text, a symbol table, and relocation bits. 
The last two may be empty if the program was 
loaded with the -s option of ld or if the sym- 
bols and relocation have been removed by strip. 


The header always contains 6 words: 


a "br .+14” instruction (205(8)) 

The size of the program text 

The size of the symbol table 

The size of the relocation bits area 
The size of a data area 

A zero word (unused at present) 


Ou BWN 


The sizes of the program, symbol table, and relo- 
cation area are in bytes but are always even, 

The branch instruction serves both to identify 
the file and to jump to the text entry point. 

The program text size includes the 6-word header. 


The data area is used when the file is executed; 
the exec system call sets the program break to 
the sum of the text size and this data size. The 
data area is generated by the assembler when the 
location counter . lies beyond the last assem- 
bled data, for example when the program ends with 
one or more constructions of the form .=.+n 3 it 
is preserved by the loader for the last program 
in a load, (Routines other than the last have 
the appropriate number of 0 words inserted, since 
there is no other provision for zero~suppression 
in an a,out file.) 


The symbol table consists of 6-word entries, The 
first four contain the ASCII name of the symbol, 
null-padded. (In fact, the assembler generates 
symbols of at most 7 bytes.) The next word is a 
flag indicating the type of symbol. The follow—- 
ing values are possible: 


00 undefined symbol 

01 absolute symbol 

O02 register symbol 

03 relocatable symbol 

40 undefined global symbol 
41 absolute global symbol 
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43 relocatable global symbol 


An undef ined global corresponds to a GMAP " sym— 
ref and an absolute or relocatable global to a 


"symdef" or absolute or relocatable value respec-— 
tively. Values other than those given above may 
occur if the user has defined some of his own 
instructions, 


The last word of a symbol table entry contains 
the value of the symbol. Its contents are not 
specified if the symbol is undefined. 


If a,out contains no unresolved global refer- 
ences, header and text portions are exactly as 
they will appear in core when the file is execut- 
ed. If the value of a word in the text portion 
involves a reference to an undefined global, the 
word is replaced by the offset in the symbol 
table of the appropriate symbol, (That is, pos- 
sible offsets are 0, 12(10), 24(10), ....) Sucha 
word will have appropriate relocation bits. 


The relocation bits portion uses a variable- 
length encoding. There is a string of bits for 
eacn word in the text portion, The scnewe nas at 
least two bits for each word, plus possibly two 
more to extend the codes available; in either 
case the bits may be followed by a 16-bit string 
to represent an offset to an external symbol, 

The bits are packed together without regard to 
word boundaries. The last word is filled out 
with O’s on the right. 


The possible relocation bit configurations are: 


00 
word is absolute 


01 
word is relocatable 


10 
word is a relative reference to an undefined 
global symbol with no offset. Currently, the 
word contains the offset in the symbol table 
of the symbol. When the symbol becomes de- 
fined, say with value x, this location will 
contain x-.-2, where . is the location of 
the word, 


1100xxxxxxXXXXXXXXXXX 
word is a relative reference to an external 
symbol with an offset, It is the same as the 
previous relocation type, except that the 
16-bit offset is added in when the symbol 
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A,OUT (V) 
becomes defined. 
1101 
word is a reference to an undefined ternal 
symbol with no offset, At present the word 


contains the symbol table offset of the sym-— 
bol, When the symbol becomes defined, the 
word will contain the value of the symbol. 


1110xxxxXXXXXXXXXKXX 
word is a reference to an undefined external 
symbol with an offset, At present, the word 
contains the symbol table offset of the sym- 
bol, When the symbol becomes defined, the 
word will contain the value of the symbol 
plus the given 16-bit offset. 


as ld, strip, nm, un 


Soon, there will be a new type of: symbol: the 
data area symbol. in tne text, 1t wiii appear as 
an ordinary external reference. However, it need 
not be defined; this will be done by the loader, 
Watch this space for more details. 


amr 
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archive (library) file format 


The archive command ar is used to combine several 
files into one, Its use has three benefits: when 
files are combined, the file space consumed by 
the breakage at the end of each file (256 bytes 
on the average) is saved; directories are smaller 
and less confusing; archive files of object pro- 
grams may be searched as libraries by the loader 
id. 


A file produced by ar has a "magic number” at the 
start, followed by the constituent files, each 
preceded by a file header, The magic number is 
-147(10), or 177555(8) (it was chosen to be un- 
likely to occur anywhere else). The header of 
each file is 16 bytes long: 


0-7 
file name, null padded on the right 


12 
User ID of file owner 


13 
file mode 


14-15 
file size 


If the file is an odd number of bytes long, it is 
padded with a null byte, but the size in the 
header is correct, 


Notice there is no provision for empty areas in 
an archive file. 


ar, id 
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BPPT (V) 


binary punched paper tape format 


Binary paper tape is used to pass and store arbi- 
trary information on paper tape. The format 
chosen has the following features: a) no format 
of the data is assumed. b) check summing c) zero 


The format is as follows: 


Between records, NULL characters are ignored, 
The beginning of the tape is considered between 
records, thus the leader is ignored, 


The first non-null character specifies the type 
and size of the record. If the character is 
positive (1 to 177), the record is a data record 
consisting of that many characters, All but the 
last of these characters are data, the last being 
a checksum, The checksum is calculated such that 
the sum of the entire record is zero mod 256, 


If the first character is negative (200-376) the 
record is a zero suppression record, It is 
identical to minus that number of zeros of data, 
One character of checksum follows this negative 
character, It is the positive of the negative 
character, 


The special case of a record looking like a sin- 
gle zero character suppressed (37731) causes no 
data transfer, but is an end-of-file indication. 


lbppt, dbppt 
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format of core image 


Three conditions cause UNIX to write out the core 
image of an executing programi the program gen— 
erates an unexpected trap (by a bus error or, 
illegal instruction); the user sends a "quit 
signal (which has not been turned off by the 
program); a trap is simulated by the floating 
point simulator, The core image is called core’ 
and is written in the current working directory 
(provided it can be; normal access controls ap— 

ply). It is exactly 8192+64 bytes long. The 
first 8192 represent the actual contents of 
memory at the time of the fault; the last 64 are 
the contents of the system’s per-user data area 
for this process. Only the first word of this 
area will be described. 


When any trap which is not an I/O interrupt oc- 
curs, all the useful registers are stored on the 
stack, After all the registers have been stored, 
the contents of Sp are placed in the first cell 
of the user area; this cell is called u.sp. 
tnereiore, within tne core samaye propel, theie is 
an area which contains the following registers in 
the following order (increasing addresses): 


pe (at time of fault) 
processor status (at time of fault) 


The last two are stored by the hardware, It fol- 
lows that the contents of sp at the time of the 
fault were (u.sp) plus 22(10). 


The t-bit (trap bit) in the stored status will be 
on when a quit caused the generation of the core 

image, since this bit is used in the implementa- 

tion of quits. 
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format of. directories 


A directory behaves exactly like an ordinary 
tile, save that no user may write into a directo-— 
ry. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its i-node 


Directory: entries are 10 bytes long, The first 
word is the i-node of the file represented by the 
entry, if non-zero; if zero, the entry is empty. 


Bytes 2-9 represent the (8-character) file name, 
null padded on the right. These bytes are not 
necessarily cleared for empty slots. 


By convention, the first two entries in each 
directory are for .,. and .. . The first is an 
entry for the directory itself, The second is 
for the parent directory. The meaning of "..” is 
modified for the root directory of the master 
file system and for the root directories of re- 
movable file systems. In the first case, there 
is nO parent, and in the second, the system does 
not permit off-device references without a mount 
system call, Therefore in both cases veer Has 
the same meaning as .. 


file system format 
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format of file system 


Every file system storage volume (e.g. RF disk, 
RK disk, DECtape reel) has a common format for 
certain "vital information, 


Every such volume is divided into a certain 
number of 256 word (512 byte) blocks. Biocks 0 
and 1 are collectively known as the super-—block 
for the device; they define its extent and con- 
tain an i-node map and a free-storage map. The 
first word contains the number of bytes in the 
free-storage map; it is always even. It is fol- 
lowed by the map, There is one bit for each 
block on the device; the bit is 1 if the block 
is free, Thus if the number of free-map bytes is 
n, the blocks on the device are numbered 0 
through 8n-1. The free-map count is followed by 
the free map itself, The bit for block k of the 
device is in byte k/8 of the map; it is offset 
k(mod 8) bits from the right. Notice that bits 
exist for the superblock and the i-list, even 
though they are never allocated or freed, 


After the free map is a word containing the byte 


count for the i-node map, It too is always even. 


I-numbers below 41(10) are reserved for special 
files, and are never allocated; the first bit in 
the inode free map refers to i-number 41. 
Therefore the byte number in the i-node map for 
i-node i is (i-41)/8. It is offset (i-41) (mod 
8), bits from the right; unlike the free map, a 
"oO" bit indicates an available i-node, 


I-numbers begin at 1, and the storage for i-nodes 
begins at block 2, Also, i-nodes are 32 bytes 
long, so 16 of them fit into a block, Therefore, 
i-node i is located in block (i+31)/16 of the 
file system, and begins 32° ((i+31)(mod 16)) bytes 
from its start, 


There is always one file system which is always 
mounted; in standard UNIX it resides on the RF 
disk. This device is also used for swapping. 
The swap areas are at the high addresses on the 
device. It would be convenient if these ad- 
dresses did not appear in the free list, but in 
fact this is not so. Therefore a certain number 
of blocks at the top of the device appear in the 
free map, are not marked free, yet do not appear 
within any file. These are the blocks that show 
up missing in a check of the RF disk. 


Again on the primary file system device, there 


11/3/71 


FILE SYSTEM (V) 


are several pieces of information following that 
previously discussed, They contain basically the 
information typed by the tm command; namely, the 
times spent since a cold boot in various ca- 
tegories, and a count of I/O errors. In particu- 


Jar there are tun words with +h a2) Aar tims 
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(measured since 00:00 Jan 1, 1971); two words 
with the time spent executing in the system; two 
words with the time spent waiting for I/O on the 
RF and RK disks; two words with the time spent 
executing in a user’s core; one byte with the 
count of errors on the RF disk; and one byte with 
the count of errors on the RK disk. All the 
times are measured in sixtieths of a second, 


I-node 41(10) is reserved for the root directory 

of the file system. No i-~numbers other than this 
one and those from 1 to 40 (which represent spe-— 

cial files) have a built-in meaning. Each i-node 
represents one file. The format of an i-node is 

as follows, where the left column represents the 

offset from the beginning of the i-node: 


on1 flags {see below) 

2 number of links 

3 user ID of owWne: 

4-5 size in bytes 

6-7 first indirect block or contents block 


20-21 eighth indirect block or contents block 
22-25 creation time 

26-29 modification time 

30-31 unused 


The flags are as follows: 


100000 i-node is allocated 

.040000 directory 

020000 file has been modified (always on) 
010000 large file 

000040 set user ID on execution 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 


The allocated bit (flag 100000) is believed even 
if the i-node map says the i-node is free; thus 
corruption of the map may cause i-nodes to become 
unallocatable, but will not cause active nodes to 
be reused, 


Byte number n of a file is accessed as follows: n 
is divided by 512 to find its logical block 
number (say b) in the file, If the file is small 
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(flag 010000 is 0), then b must be less than 8, 
and the physical block number corresponding to b 
is the bth entry in the address portion of the 


Fteonnda 
a27HiVao, 


If the file is large, b is divided by 256 to 
yield a number which must be less than 8 (or the 
file is too large for UNIX to handle). The 
corresponding slot in the i-node address portion 
gives the physical block number of an indirect 
block, The residue mod 256 of b is multiplied by 
two (to give a byte offset in the indirect block) 
and the word found there is the physical address 
of the block corresponding to b. 


If block b in a file exists, it is not necessary 
that all blocks less than b exist. A zero block 
number either in the address words of the i-node 
or in an indirect block indicates that the | 
corresponding block has never been allocated, 
Such a missing block reads as if it contained all 
zero words, 


FILES _ 

SEE ALSO format of directories 

DIAGNOSTICS -- 

BUGS Two blocks are not enough to handle the i- and 
free-storage maps for an RPO2 disk pack, which 
contains around 10 million words, 

OWNER -- 
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passwd -- password file 


passwd contains for each user the following 
information: 


name (login name) 
password 

numerical user ID 

default working directory 
program to use as Shell 


This is an ASCII file. Each field within each 
user’s entry is separated from the next by a 
colon, Each user is separated from the next by a 
new-line, If the password field is null, no 
password is demanded; if the Shell field is null, 
the Shell itself is used. 


This file, naturally, is inaccessible to anyone 
but the super-—-user, 


This file resides in directory /etc. 


fete/init 


super-user 
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fetc/uids --— map user names to user IDs 


This file allows programs to map user names into 
user numbers and vice versa. Anyone can read it. 
It resides in directory /etc, and should be up- 
dated along with the password file when a user is 
added or deleted, 


The format is an ASCII name, followed by a colon, 
followed by a decimal ASCII user ID number, 
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/tmp/utmp --— user information 


This file allows one to discover information 
about who is currently using UNIX. The file is 
binary; each entry is 16(10) bytes long. The 
first eight bytes contain a user’s login name or 


are mulls, ff the table slict 26 unused, The jon 
order byte of the next word contains the last 
character of a typewriter name (currently, °’0’ to 
°5° for /dev/ttyO to /dev/tty5)., The next two 
words contain the user’s login time, The last 


word is unused, 


This file resides in directory /tmp. 


/etc/init, which maintains the file, 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 


DIAGNOSTICS 


BASIC (VI) 


basic -~ DEC supplied BASIC 
basic [file] 


Basic is the standard BASIC vOOO distributed as a 
stand alone program, The optional fiie argument 
is read before the console. See DEC-11-AJPB-—D 
manual, 


Since bas is smaller and faster, basic is not 
maintained on line. 


See manual 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


BI (VI) 


bj -- the game of black jack 
/usr/games/bj 


Black jack is a serious attempt at simulating the 
dealer in the game of biack jack (or twenty-one) 
as might be found in Reno, 


The following rules apply: 
The bet is $2 every hand. 


A player ‘natural’ (black jack) pays $3. A 
dealer natural loses $2. Both dealer and 
player naturals is a ‘push’ (no money ex- 
change). 


If the dealer has an ace up, the player is 
allowed to make an ‘insurance’ bet against the 
chance of a dealer natural. If this bet is 
not taken, play resumes as normal. If the bet 
is taken, it is a side bet where the player 
wins $2 if the dealer has a natural and loses 
$1 if the dealer does not, 


im the piayer is dealt two cargs of the saiie 
value, he is allowed to ‘double’, He is al- 
lowed to play two hands, each with one of 
these cards. (The bet is doubled also; $2 on 
each hand.) 


If a dealt hand has a total of ten or eleven, 
the player may ‘double down’. He may double 
the bet ($2 to $4) and receive exactly one 
more card on that hand. 


Under normal play, the player may ‘hit’ (draw 
a card) as long as his total is not over 
twenty-one. If the player ‘busts’ (goes over 
twenty-one), the dealer wins the bet. 


When the player ‘stands’ (decides not to hit), 
the dealer hits until he attains a total of 
seventeen or more, If the dealer busts, the 
player wins the bet. 


If both player and dealer stand, the one with 
the largest total wins. A tie is a push. 


The machine deals and keeps score, The following 
questions will be asked at appropriate times. 
Each question | is answered by y followed re a new 
line for ‘yes’, or just new line for *no’ 


? means ’do you want a hit?’ 
Insureance? 
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FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


BJ (VI) 


Double down? 


Every time the deck is shuffled, the dealer so 

states and the ‘action’ (total bet) and “stand- 
ing’ (total won or loss) is printed, To exit, 

hit the interrupt key (DEL) and the action and 

standing will be printed. 
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SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


CAL (VI) 


cal -— print calendar 
/usr/ken/cal year 


Cal will print a calendar for the given year, 

The year can be between O (really 1 BC) and 9999, 
For years when several calendars were in vogue in 
different countries, the calendar of England (and 
therefore her colonies) is printed, 


5-52; 


P.S, try cal of 1752, 
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NAME 
SYNOPSIS 


DESCRIPTION 


CHESS (VI) 


chess --— the game of chess 
/usr/games/chess 


Chess is an attempt at computer chess, The pro- 
gram ‘speaks’ in algebraic chess notation. The 
initial board configuration in this notation is 
as follows: 


* 1 ww 
* | tow 
*'IO 
* oO WD 
* 1 ue 
xy 


* 1 
* | 
*1 OAK 
* | 
* | 


]HN WADI 0 


MHD *I 
AWD *!1 
aa ! 
OA'O * I 
Mod | 
gato *! 
TRO I 


A move is specified by the ’from’ co-ordinate 
followed by the ‘to’ co-ordinate. Thus the white 
P-K4 move would be ’e2e4’, The black P-K4 would 
be ’e7e5’, 


The following commands are recognized by the 
chess program: 


move 
Make the move if legal. The program does not 
keep track of who is to play. The move is 
made for what ever side is specified, 


move xX 
Make the move regardless of legality. This is 
a good way to either set up a desired situa- 
tion or to cheat, The initial move ’e2e8x’ is 
a winner, 


The program will compute and make a move for 
the white pieces, 


1B 


The program will compute and make a move for 
the black pieces, 


lab 

Set the level parameters to a and b, where a 
and b are numbers between O and 9. The ini- 
tial settings are 2 and 8. The first parame— 
ter increases computation time rapidly while 
the second parameter only increases computa- 
tion exponentially. Currently move times run 
from 20 seconds to 10 minutes, It was hoped 
that these numbers would be usefully related 
to the program’s competence, 
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FILES 
SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


CHESS (VI) 


B 
The board is printed, 

u 
The last move is un-made. This is another 
good way to cheat, 

i 
Ali the moves to date are printed, 

8 
The current game situation is saved on the 
file c.tmp. 

= 
The game situation on the file c.tmp is re- 
stored, 

icommand 


The unix command is executed by the mini- 
shell. 


An interrupt (DEL) will pull the program out of 
its computation, If it is trying to make a move, 
the best move to date is made, 

c,tmp 


msh 


? if an illegal move is attempted, or if an un- 
known command is typed. 


The current version does not recognize castling, 
promotion and en passant. A new version is in 
the mill, 


ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


das --— disassembler 


A PDP-11 disassembler 
for more information. 


exists. 


DAS (VI) 


Contact the author 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


DLI (VI) 


dli ~- load DEC binary paper tapes 

dali output [input] 

Gli will load a DEC binary paper tape into the 
output file. The binary format paper tape is 
read from the input file (/dev/ppt is default, ) 
/dev/ppt 


“checksum” 


amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


DPT (VI) 


dpt -- read DEC ASCII paper tape 

dpt output [input] 

apt reads the input file (/dev/ppt default) as— 
suming the format if a DEC generated ASCII paper 


tape of an assembly language program, The output 
is a UNIX ASCII assembly program, 


/dev/ppt 


Almost always a hand pass is required to get a 
correct output. 
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NAME 
SYNOPSIS 
DESCRIPTION 


FILES 


DIAGNOSTICS 
BUGS 


OWNER 


moo -— a game 
/usr/games/moo 


moo is a guessing game imported 


MOO (VI) 


from England, 


11/3/71 SORT (VI) 


NAME sort -- sort a file 
SYNOPSIS sort input output 
DESCRIPTION sort will sort the input file and write the sort-— 


ed file on the output file, Wide options are 
available on collating sequence and ignored char- 
acters, 

FILES -- 

SEE ALSO -- 

DIAGNOSTICS -- 

BUGS -- 


OWNER admr, ken 


VASS/74 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


TTT (VI) 


ttt -- tic-tac-—toe 
/usr/games/ttt 
cyOe 
ttt is the X’s and O’s the-+* popular in ist 


grade, This is a learning program that never 
makes the same mistake twice, 


ttt.k -- old mistakes 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


as2 -~ assembler pass 2 


as2 is invoked by the assembler as 
second pass. 


see as 


/ETC/AS2 (VII) 


to perform its 


11/3/71 /ETC/ASCII (VII) 


NAME ascii -- map of ASCII character set 
SYNOPSIS cat /etc/ascii’ 
DESCRIPTION ascii is a map of the ASCII character set, to be 
printed as needed. It contains: 
{000 nul}001 soh!002 stx!003 etx!004 eot!005 eng!006 ack!007 bel} 
{O10 bs ;O14 ht {O12 nl {013 vt {O14 np {O15 cr [016 so [017 si } 
{020 dlej021 dc1}022 dc2}023 dc3{024 dc4/025 nak!026 syn}027 etb} 
|030 canj031 em {032 subj033 esc{034 fs {035 gs {036 rs {037 us | 
1040 sp {041 ! {042 1043 # 1044 $ 1045 % {046 & [047 _ H 
i050 ( {051 ) {052 * {053 + 1054 , {055 - {056 . jo57 / } 
i060 O {061 1 {062 2 {063 3 {!064 4 {065 5 /066 6 {067 7 } 
1070 8 {071 9 {O72 : {073 3; $074 < |075 = {1076 > {077 ? | 
1100 @ {101 A {102 B {103 C 1104 D |105 E {106 F |107 G } 
i110 H {111 I 4112 J {113 K $114 L 4115 M 4116 N 1117 O ] 
1420 P 11214 Q j122 R 1123 S {124 T {125 U 4126 Vv (127 | w i 
i430 X {134 Y {132 2 {133 €[ {134 \ {135 J 4136 (h37 4 
1140 * {1414 a {142 b {143 c 1144 da $145 e {146 £ 1147 g | 
i150 h {151 a 4152 j {153 k $154 1 4155 m {156 n 1157 © | 
i160 p {161 q {162 r {163 s {164 t {165 u {166 v {167 Ww | 
p70 ow AT oy 1972 of 4473 4 1474 + [47S 6} Aas 1177 del} 
FILES == 
SEE ALSO — ee 
DIAGNOSTICS —— 
BUGS => 


OWNER jfo 
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NAME ba -~- B assembler 

SYNOPSIS /etc/ba name 

DESCRIPTION ba is invoked by the B command in order to turn 
the B intermediate code into assembiy ianguage. 

FILES name.i (input), name.s (output) 

SEE ALSO b command, /etc/be 

DIAGNOSTICS -- 

BUGS At the moment, the b command is defunct, and ba 


is invoked via a command file, 


OWNER ken 
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NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


/ETC/BC (VIL) 


be -- B compiler 
/etc/be name.b name.i 
be is the B 


into interme 
command, 


it turns B sour 
Ss invoked from 


c 
t 
name.b (input), name.i (intermediate output) 
b (command), /etc/ba 


The b command is defunct at the moment; bc is 
called from a command file. 


ken 


e 
— 
ie 


ler 
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NAME bilib -- B interpreter library 


SYNOPSIS -- 

DESCRIPTION bilib is the library of B runtime operators. It 
is searched during the loading of a B-compiled 
program. 

Standard B subroutines are contained in 
/etc/libb.a. 

FILES ie 

SEE ALSO b (command); ar, ld 

DIAGNOSTICS er 

BUGS The following assignment binary operators are 
missing: b102 (=|), b103 (=&), b104 (===), b105 
(=!=), b106 (=<=), b107 (=<), b110 ae b111 

=/). 


(=>), b112 (=>>), b113 (=<<), b120 ( 


OWNER ken, dmr 
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NAME 
SYNOPSIS 


DESCRIPTION 


173740: 


BOOT PROCEDURES (VII) 


bos, maki, rom, vcboot, msys, et al 


—— 


On the RF disk, the highest 16K words are 
reserved for stand-alone programs. These i 6 
words are allocated as follows: 


. 


bos (1K) 
Warm UNIX ( 6K) 
Cold UNIX (6K) 
unassigned (3K) 


The UNIX read only memory (ROM) is home cut with 
2 programs of 16 words each. The first (address 
173700) reads bos from the RF disk into core 
location 54000 and transfers to 54000. The other 
ROM program (address 173740) reads a DECtape sit- 
ting in the end-zone on drive 0 into core loca- 
tion 0 and transfers to 0. This latter operation 
is compatible with part of DEC’s standard ROM. 
The disassembled code for the UNIX ROM follows: 


mov $177472,r0 127003177472 
mov $3,-(r0) 1274033 

mov $140000U,-(r0) 127403140000 
mov $54000,-(r0) 12740;54000 
mov $-2000,-(r0) 127403176000 
mov $5,-(r0) 1274035 

tstb (rQ) 105710 

bge .-2 2376 

jmp *$54000 137354000 
mov $177350,r0 127003177350 
clr -(r0) 5040 

mov r0,-(r0) 10040 

mov $3,-(r0) 12740;3 

tstb (r0) 105710 

bge <— 2376 

tst *$177350 57373177350 
bne . 1377 

movb $5,(r0) 11271035 
tstb (r0) 105710 

bge .-2 2376 

clr pc 5007 


The program bos (Bootstrap Operating System) 
examines the console switchs and executes one of 
several internal programs depending on the set- 


ting. 
waiting for a recognizable setting. 


If no setting is recognizable, bos loops 


The follow- 


ing settings are currently recognized: 


173700 
73700 


Will read Warm UNIX from the RF into core 
location O and transfer to 400. 
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BOOT PROCEDURES (VII) 
1 Will read Cold UNIX from the RF into core 
location O and transfer to 400. 


2 Will read the unassigned 3K program into 
core location O and transfer to 400. 


10 Will dump 12K words of memory from core 
location 0 onto DECtape drive 7. 

fe) Will load a standard UNIX binary paper 
tape into core location 0 and transfer to 
0. 


57500 Will load the standard DEC absolute and 
binary loaders and transfer to 57500. 


Thus we come to the UNIX warm boot procedure: put 
173700 into the switches, push load address and 
then push start. The alternate switch setting of 
73700 that will load warm UNIX is used as a sig- 
nal to bring up a single user system for special 
purposes. See /etc/init. 


Cold boots can be accomplished with the Cold UNIX 
program, but they’re not. Thus the Cold UNIX 
Slot on the RF may have any program desired. 

This slot is, however, used during a cold boot. 
Mount the UNIX INIT DECtape on drive O posi 
tioned in the end-zone. Put 173740 into the 
switches, Push load address. Put 1 into the 
switches. Push start. This reads a program 
called vcboot from the tape into core location 0 
and transfers to it. vecboot then reads 16K words 
from the DECtape (blocks 1-32) and copies the 
data to the highest 16K words of the RF. Thus 
this initializes the read-only part of the RF. 
vcboot then reads in bos and executes it. bos 
then reads in Cold UNIX and executes that. Cold 
UNIX halts for a last chance before it completely 
initializes the RF file system. Push continue, 
and Cold UNIX will initialize the RF. It then 
sets into execution a user program that reads the 
DECtape for initialization files starting from 
block 33. When this is done, the program exe- 
cutes /etc/init which should have been on the 
tape. 


The INIT tape is made by the program maki running 
under UNIX, maki writes vcboot on block O of 
/dev/tap7. It then copies the RF 16K words 
(using /dev/rf0) onto blocks 1 thru 32. It has 
internally a list of files to be copied from 
block 33 on. This list follows; 


fetce/init 
/ bin/chmod 


11/3/71 


FILES 


SEE ALSO 


DIAGNOSTICS 


BUGS 


OWNER 


BOOT PROCEDURES (VII) 


/bin/chown 
/bin/cp 
/bin/in 
/bin/1s 
/bin/mkdir 


/ain/my 
/ bLa/TRV 


/bin/rm 
/bin/rmdir 
/bin/sh 
/bin/stat 
/bin/ tap 


Thus this is the set of programs available after 
a cold boot. /etc/init and /bin/sh are mandato- 
ry. /bin/tap and /bin/mkdir are used to load up 
the file system. The rest of the programs are 
frosting. AS soon as possible, an sdate should 
be done. 


The last link in this incestuous daisy chain is 
the program msys. 


msys char file 


will copy the file file onto the RF read only 


Po a : a Mee 3, a Nghe, ie A eee ee ae Le a, Pee oe Oe oe 
Sioct specified b the characacter char. enhaLt is 
¥ x eae 


taken from the following set: 


bos 

Warm UNIX 
Cold UNIX 
unassigned 


Inf Ie Io’ 


Due to their rarity of use, maki and msys are 
maintained off line and must be reassembled be- 
fore used, 


/dev/rf0, /dev/tapn 


/etc/init, /bin/tap, /bin/sh, /bin/mkdir, bppt 
format 


The files /bin/mount, /bin/sdate, and /bin/date 
should be included in the initialization list of 
maki. 


ken 
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SYNOPSIS 


DESCRIPTION 


FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


/ETC/BRT1, BRT2 (VII) 


brt1, brt2 -- B runtime routines 


The first of these routines must be loaded first 
in an executable B program; the second must be 
loaded last, after all other routines. They are 
not in /etc/bilib only because having them 
separate is the easiest way to assure the order 


of loading. 


b command, bilib 
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FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OW NE K 


/ETC/F1, F2, F3, F4 (VII) 


f1, £2, £3, £4 -- Fortran compiler 


These programs represent the four phases of a 
Fortran compilation: 

fi: specification statements 

£2: common and equivalence allocation 

£3: executable statements 

£4: cleanup 


Each exec’s the next; the first is called by the 
for command, 


f£.tmpi, f.tmp2, f.tmp3 


for 


Besides the fact that there is a good deal of the 
Fortran language missing, there is no for 
command; Fortran is invoked via a command file. 


Ken, amr 


11/3/71 


NAME 
SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


/ETC/GLOB (VII) 


glob -- global 


glob is used to expand arguments to the shell 
containing * or ? . It is passed the argument 
list containing the metacharacters; glob expands 
the list and calls the command itself. 


sh 

"No match”, “no command” 

giob will only load a command from /bin. Also if 
any * or ? argument fails to generate 
matches, No match is typed and the command is 


not executed, 


amr 
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NAME 
SYNOPSIS 


DESCRIPTION 


/ETC/INIT (VII) 


init -- process initialization 


init is invoked inside UNIX as the last step in 


the boot procedure. It first carries out several 


housekeeping duties: it must change the modes of 
the tape files and the RK disk file to 17, be- 
cause if the system crashed while a tap or rk 
command was in progress, these files would be 
inaccessible; it also truncates the file 
/tmp/utmp, which contains a list of UNIX users, 
again as a recovery measure in case of a crash, 
Directory usr is assigned via sys mount as 
resident on the RK disk. 


init then forks several times so as to create one 
process for each typewriter channel on which a 
user may log in. Each process changes the mode 
of its typewriter to 15 (read/write owner, 
write-only non-owner; this guards against random 
users stealing input) and the owner to the 
super-user., Then the typewriter is opened for 
reading and writing. Since these opens are for 
the first files open in the process, they receive 
the file descriptors 0 and 1, the standard input 
and output file descriptors. It is likely that 
no one is dialled in when the read open takes 
place; therefore the process waits until someone 
calls. At this point, init types its login: 
message and reads the response, which is looked 
up in the password file. The password file con- 
tains each user’s name, password, numerical user 
ID, default working directory, and default shell. 
If the lookup is successful and the user can sup- 
ply his password, the owner of the typewriter is 
changed to the appropriate user ID. An entry is 
made in /tmp/utmp for this user to maintain an 
up-to-date list of users. Then the user ID of 
the process is changed appropriately, the current 
directory is set, and the appropriate program to 
be used as the Shell is executed. 


At some point the process will terminate, either 


- because the login was successful but the user has 


now logged out, or because the login was unsuc- 
cessful. The parent routine of all the children 
of init has meanwhile been waiting for such an 
event. When return takes place from the sys 
wait, init simply forks again, and the child pro- 
cess again awaits a user. 


There is a fine point involved in reading the 
login message. UNIX is presently set up to han 
dle automatically two types of terminals: 150 
baud, full duplex terminals with the line-feed 
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FILES 
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DIAGNOSTICS 


BUGS 


OWNER 


/ETC/INIT (VII) 


function (typically, the Model 37 Teletype termi- 
nal), and 300 baud, full duplex terminals with 
only the line-space function (typically the GE 
TermiNet terminal). The latter type identifies 
itself by sending a line-break (long space) sig- 
nal at login time. Therefore, if a null charac- 
ter is received during reading of the login line, 
the typewriter mode is set to accommodate this 
terminal and the login: message is typed again 
(because it was garbled the first time). 


Init, upon first entry, checks the switches for 
73700. If this combination is set, init will 
open /dev/tty as standard input and output and 
directly execute /bin/sh. In this manner, UNIX 
can be brought up with a minimum of hardware and 
software, 


/tmp/utmp, /dev/ttyO ... /dev/ttyn 
sh 


7 " vw « o 
No directory , No shell . There are also some 
halts if basic I/O files cannot be found in /dev. 
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/ETC/KBD (VII) 


kbd -- keyboard map 
cat /etc/kbd 


kbd contains a map to the keyboard for model 37 
Teletype terminais with the extended character 
set feature, If kbd is printed on such a termi- 
nal, the following will appear: 

<[(1234567890-_]“\ >qwertyuiop@ asdfghjkl;: zxcvbnm,./ 


<71234567890--afY > v He gel 


<{1"#$%&’ () =_}7} DQWERTYUIOP* ASDFGHJKL+* ZXCVBNM,.? 


<1" #8%&() =r LAA COTO aceser¥nprA+* NEwySny,.? 
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FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 


OWNER 


/ETC/LIBA.A (VII) 


liba.a -- assembly language library 


This library is the standard location for 
assembly-language subroutines of general use. 
section of this manual is devoted to its con- 
tents. 


Hing 


This library is searched when the link editor ld 
encounters the -l argument. 


id; library manual 
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/ETC/LIBB.A (VIL) 


libb.a -- B library 


This library contains all B-callable subroutines 

of general utility. Its contents are detailed in 
the library section of the B manual. At present 

its contents are; 


char 
getchr 
putchr 
exit 
printf 
seek 
setuid 
stat 
time 
unlink 
wait 
lchar 
chdir 
chmod 
chown 
Close 
creat 
exec] 
execv 
fork 
fstat 
getuid 
intr 
link 
makdir 
open 
read 
write 
ctime 


ken, dmr 
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DIAGNOSTICS 


BUGS 


OWNER 


LIBF.A (VII) 


f/etc/libf.a -- Fortran library 


This library contains all the Frotran runtime 
routines. Many are missing. 


Will be renamed, and libf.a reserved for 
subroutines and functions. 


ken, dmr 
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NAME logging in and logging out 
SYNOPSIS tars 
DESCRIPTION UNIX must be cailed from an appropriate terminal. 


The two general classes of terminals which UNIX 
Supports are typified by the 37 Teletype on the 
one hand and the GE TermiNet 300 and Memorex 1240 
on the other. The principal difference is the 
baud rate (150 vs. 300) and the treatment of the 
Carriage return Character. Most terminals 
operating at 150, 300, or 1200 baud using the 
ASCII character set either work (more or less) at 
the moment or can be used by special arrangement. 
In particular, special arrangement is necessary 
for terminals which do not generate lower-case 
ASCII characters. 


It is also necessary to have a valid UNIX user ID 
and (if desired) password. These may be ob- 
tained, together with the telephone number, from 
the system administrators, 


The same telephone number serves terminals 
operating at both the standard speeds. Whena 
connection is established via a 150-baud terminal 
(e.g. TTY 37) UNIX types out login: ; you 
respond with your user name, and, if a mask is 
typed, with a password. If the login was suc- 
cessful, the @ character is typed by the Shell 
to indicate login is complete and commands may be 
issued. A message of the day may be typed if 
there are any announcements. Also, if there is a 
file called mailbox , you are notified that 
someone has sent you mail. (See the mail com- 
mand, ) 


From a 300~baud terminal, the procedure is 
slightly different. Such terminals often have a 
full-duplex switch, which should be turned on (or 
conversely, half-duplex should be turned off). 
When a connection with UNIX is established, a few 
garbage characters are typed (these are the 
login: message at the wrong speed). You should 
depress the break key; this is a speed—- 
independent signal to UNIX that a 300-baud termi- 
nal is in use, It will type login: (at the 
correct speed this time) and from then on the 
procedure is the same as described above. 


Logging out is simple by comparison (in fact, 
sometimes too simple). Simply generate an end- 
of-file at Shell level by using the EOT 
character; the login: message will appear again 
to indicate that you may log in again. 


11/3/71 


FILES 
SEE ALSO 
DIAGNOSTICS 


BUGS 


OWNER 


LOGIN, LOGOUT (VII) 


It is also possible to log out simply by hanging 
up the terminal; this simulates an end-of-file on 
the typewriter. 


Hanging up on programs which never read the type- 
writer or which ignore end-of-files is very 
dangerous; in the worst cases, the programs can 
only be halted by restarting the system. 


ken, dmr 
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/ETC/MSH (VII) 


msh -- mini-shell 


msh is a heavily simplified version of the Shell. 
It reads one line from the standard input file, 
interprets it as a command, and calls the com- 
mand. 


The mini-shell supports few of the advanced 
features of the Shell; none of the following 
characters is special: 


>< s$\3 & 


However, "*" and "?" are recognized and glob is 
called. The main use of msh is to provide a 
command-executing facility for various interac- 
tive sub-systems. 


sh, glob 
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/ETC/SUFTAB (VIL) 


suftab -- suffix table 


— 


suftab is a table of suffixes used to guide 
hyphenation in roff. Its first 12 words are not 
used (see a.,out Yormat.) Its next 26 words point 
to the beginning of the subtables for each of the 
26 initial letters of a suffix. The first entry 
for each suffix is a count of the number of bytes 
in the suffix. The second byte of each entry is 
a flag indicating the type of suffix. The suffix 
itself follows; the high bits of each letter 
indicate where the hyphens come. The table for 
each initial suffix letter ends with a zero count 
byte ° 


jto, dmr, ken 
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/ETC/TABS (VIL) 


tabs -~ tab stop set 
cat /etc/tabs 


When printed on a suitable terminal, this file 
will set tab stops at columns 8, 16, 24, 32, eee. 
Suitable terminals include the Teletype model 37 
and the GE TermiNet 300. 


Since UNIX times delays assuming tabs set every 
8, this has become a defacto ‘standard.’ 


